RSTS-11 
System User’s Guide 


Order No. DEC-11-ORSUA-D-D 


fifo} i} tall 


RSTS-11 
System User’s Guide 


Order No. DEC-11-ORSUA-D-D 


digital equipment corporation - maynard. massachusetts 


First Printing, September 1972 
First Revision, May 1973 
Second Revision, September 1974 
Third Revision, July 1975 


The information in this document is subject to change without notice 
and should not be construed as a commitment by Digital Equipment 
Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this document. 


The software described in this document is furnished under a license 
and may only be used or copied in accordance to the terms of such 
license. 


Digital Equipment Corporation assumes no responsibility for the use 
or reliability of its software on equipment that is not supplied by 
Digital. 


Copyright () 1972, 1973, 1974, 1975 by Digital Equipment Corporation 


The postage prepaid READER'S COMMENTS form on the last page of this 
document requests the user's critical evaluation to assist us in 
preparing future documentation. 


The following are trademarks of Digital Equipment Corporation: 


DIGITAL ° DECsystem-10 MASSBUS 
DEC DECtape OMNIBUS 
PDP DIBOL 0s/8 

DECUS EDUSYSTEM PHA 
UNIBUS FLIP CHIP RSTS 
COMPUTER LABS FOCAL RSX 

COMTEX INDAC TYPESET-8 
DDT LAB-8 TYPESET-11 
DECCOMM 


LIMITED RIGHTS LEGEND 


Contract No. 


Contractor or Subcontractor: Digital Equipment Corporation 


All the material contained herein is considered limited rights data 
under such contract. 


1/77-15 


PREFACE 


CHAPTER 


CHAPTER 


1 

1.1 
1.2 
2 

2,1 
2.1.1 
2.1.2 
2.1.3 
2.1.4 


MM NH DN PD PD PD PD PDO 
e 

NM NY KH PD PD HD BP PDO DO 
e 

MOON OA PWD — 


No RD PD 
e 

GW WW 
es 

won 


PRARRERALR 


ee 
se 8 @ 
NO © BR ND — 


NO ND DD DO PD PO PO 
e 


CONTENTS 


INTRODUCTION TO RSTS-11 
TIMESHARING 

USING RSTS-11 

RSTS-11 SYSTEM COMMANDS 

ON-LINE WITH RSTS=11 
Project-Programmer Numbers and Passwords 


Getting OnLine, HELLO Command 
Going Off-Line, BYE Command 


Commands That Can Be Given Without Logging into the System 


CREATING A BASIC-PLUS PROGRAM 
NEW Command 

Input of the New Program 

Editing BASIC-PLUS Programs 

LIST Command 

DELETE Command 

RENAME Command 

Debugging BASIC-PLUS Programs 
CONT Command 

CCONT Command 


EXECUTING A BASIC-PLUS PROGRAM 
RUN Command 

Program Segmenting, CHAIN Statement 
COMPILE Command 


PROGRAM FILE MANIPULATION 

SAVE Command 

Recalling a Saved Program, OLD Command 
Merging Two Source Programs, APPEND Command 
File Protection and Renaming, NAME-AS Statement 
System Library Files 

Removing a Saved Program, UNSAVE Command 
Updating a Saved Program, REPLACE Command 


SYSTEM STATUS REPORTS 


LENGTH Command 
CATALOG Command 


1 U t 
<0 © NI O 


ag be 
WNN Oo 


Pe RRS PRON NO ENS 


1 
a Om © 


NN ht 
A 


2.6 USING RSTS-11 INPUT/OUTPUT DEVICES 
2.6.1 Disable Terminal Echo, TAPE Command 
2.6.2 Enable Terminal Echo, KEY Command 
2.6.3 Seize Device, ASSIGN Command 
2.6.4 Release Device, DEASSIGN Command 
2.6.5 Transfer Device, REASSIGN Command 
2.7 LOGICAL NAMES FOR DEVICES AND ACCOUNTS 
2.7.1 Logical Assignment of a User Account 
24762 Disk Access by Pack Identification Label 
2.7.3 Changing Default Protection Code 
2.7.4 Changing the Magtape Labeling Default 
2.8 SCALED ARITHMETIC, SCALE COMMAND 

CHAPTER 3 SPECIAL CONTROL CHARACTERS 
3.1 RETURN KEY 
3.2 ESCAPE OR ALT MODE KEY 
3.3 LINE FEED KEY 
3.4 RUBOUT KEY 
3.5 CTRL/C 
3.6 CTRL/U 
3.7 CTRL/O 
3.8 TAB CHARACTER 
3.9 CTRL/Z 
3.10 CTRL/S 

CHAPTER 4 RSTS-11 SYSTEM PROGRAMS 


4,1 LOGIN PROGRAM 

4.1.1 Running LOGIN From a Logged Out Terminal 

4.1.2 Running LOGIN at a Logged in Terminal 

4.1.3 Running Other Programs from a Logged Out Terminal 


4.2 LOGOUT PROGRAM 

4.3 SYSTAT PROGRAM 

4.3.1 SYS as a CCL Command 

4.4 PIP PROGRAM 

4.4.1 PIP Command Line Specifications 

4.4.2 File Transfers Including Merge Operations 


A RE 

° 
so <O 
e 


° 
e 
NOOR WH — 


PPR RRA A 
Ss es ss 
oo00000 0 


oo 8 e@ 
e 


PARRA RA RAL 
CONA AAR WN — 


parr ar ee ea an ea oy 
NNNNNNYNN DD 
e 
° 


oe 
ee 

e 
aAnRWN 


RON ma ae ea es ees 


PARR RRARA A 


— 


Change Filename or Protection Code 

File Deletions 

Zero Device Directory 

List Device Directory 

Guidelines for Transfer Operations and DECtape Usage 
PIP as a CCL Command 


TTYSET PROGRAM 

ESCAPE, ALTMODE, and PREFIX Characters 
Lower and Upper Case Characters 
Generalized Fill Characters 

XON/XOFF Remote Reader Contro! 

Output Parity Bit 

SET as a CCL Command 


QUOLST PROGRAM 
MONEY PROGRAM 
GRIPE PROGRAM 


EDIT PROGRAM 
EDIT as a CCL Command 


BACKUP PROGRAM 

Running and Terminating BACKUP 
BACKUP Command Specification 

Magtape Characteristics 

Disk Characteristics 

DECtape Characteristics 

General Usage of BACKUP Commands 
Privileged BACKUP Commands and Options 


QUE PROGRAM 

Running QUE at a Terminal 

Using the Q Command 

Using the L Command 

Using the K Command 

Chaining to QUE from a User Program 
Error Messages and Codes 

Running QUE by CCL Commands 
Running QUE at a Logged Out Terminal 


BATCH PROCESSING 
Control Statements 
Command Field 
Specification Fields 
Comments 

Syntactical Rules 
Syntax Example 

File Specifications 
Filename Specification 


Batch Operating Procedures 


4.12,2.2 File Type Specification 

4.12.2.3 File Specification Defaults 

4.12.2.4 Switch Specification 

4.12.3 BATCH Commands 

4.12.3.1 $JOB 

4.12.3,2 $EOJ 

4,12,3.3 $BASIC 

4,12.3.4 Utility BATCH Commands 

4,12.3.5 $RUN 

4.12.3.6 $DATA 

4.12.3.7 $EOD 

4.12.3.8 $MESSAGE 

4.12.3.9 $MOUNT 

4,12.3.10 $DISMOUNT 

4.12.3.11 $COBOL 

4.12.3.12 $SORT 

4.12.4 

4,12.4.1 Requesting a Batch Job Run 

4.12.4.2 Batch Processing 

4.12.4.3 Error Procedures 

4.13 DIRECT PROGRAM - DIRECTORY LISTINGS 

4-13.1 DIR as a CCL Command 

4.14 UMOUNT PROGRAM - MOUNTING AND DISMOUNTING 
PRIVATE DISKS 

4,15 FILCOM PROGRAM 

4.16 INUSE PROGRAM 

4.17 COPY PROGRAM 

4,18 EXTENDED PIP PROGRAM 

4.18.1 Wild Card Specifications 

4.18.2 Extended PIP Defaults and Additional Options 

4.18.3 Wild Card Specifications in Transfer and Directory Listing 
Commands 


4.18.4 Wild Card Specifications in Rename Commands 
4.18.5 Wild Card Specifications in Delete Commands 
4.18.6 Processing ANSI Magtape Files 

4.18.7 Indirect Command Files in Extended PIP 

4.18.8 Extending the Physical Command Line - /MORE 


CHAPTER 5 RSTS-11 PERIPHERAL DEVICES 


5.1 ASR-33 TELETYPE 

5.1.1 Control Knob 

5.1.2 Keyboard 

5.1.3 Printer 

5.1.4 Low-Speed Paper Tape Reader 
5.1.5 Low-Speed Paper Tape Punch 


vi 


5.10 
APPENDIX A 
A. 
A.2 
A.3 
A.4 
APPENDIX B 
APPENDIX C 
C.1 
C.2 


C.3 


HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 
High-Speed Reader Unit 

High-Speed Punch Unit 

CRI7 CARD READER 

LP11 LINE PRINTER 

Line Printer Character Set 

Line Printer Operation 

TC11/TU56 DECTAPE CONTROL AND TRANSPORT 
TM11/TUIO AND TJU16 MAGTAPE CONTROL AND 
TRANSPORT 

Magtape Control Panel 

Magtape Operating Procedures 


VT@5 ALPHANUMERIC DISPLAY TERMINAL 
Controls and Operating Procedures 


2741 COMMUNICATIONS TERMINALS 
The ATTN Key 

The RETURN Key 

The BKSP Key 

Bracket Characters 

Changing Codes 

LA36 DECWRITER II 

RX11 FLOPPY DISK 

BASIC-PLUS LANGUAGE SUMMARY 
SUMMARY OF VARIABLE TYPES 
SUMMARY OF OPERATORS 

SUMMARY OF FUNCTIONS 
SUMMARY OF BASIC-PLUS STATEMENTS 
BASIC=-PLUS COMMAND SUMMARY 
ERROR MESSAGE SUMMARY 

USER RECOVERABLE ERRORS 
NON-RECOVERABLE ERRORS 


SYSTEM IDENTIFICATION MESSAGE 


vii 


C-10 


APPENDIX D 


INDEX 


D.1 
D.2 
D.3 


D.4 


BASIC-PLUS CHARACTER SET 
BASIC-PLUS CHARACTER SET 
ASCII CHARACTER CODES 
CARD CODES 


RADIX-58 CHARACTER SET 


FIGURES 


TAB Character Example 

ASR-33 Teletype Console 

Teletype Keyboard 

High-Speed Paper Tape Reader/Punch 
CR11 Punched Card Reader 


LP11 Line Printer System (88-column model) 


Line Printer Control Panel 

TU56 DECtape Transport 

DEC Magnetic Tape System 

Control Panels 

Magtape Transport Threading Diagram 
VT@5 Keyboard 

VT05 Alphanumeric Display Terminal 
Correspondence Code Keyboard 
EBCD Keyboard 

BCD Keyboard 

CALL/360 BASIC 


TABLES 


Logged-Out RSTS-11 Commands 
Device Specifications 

LOGOUT CONFIRM: Responses 
SYSTAT Options 

SYSTAT Abbreviations 

Output File Specification Elements 
Input File Specification Elements 
File Transfer and Merge Options 
PIP Directory Listing Options 

Input File Specifications 

RSTS/E TTYSET Commands 

RSTS (Version 4) TTYSET Command 
Default Single Characteristic Settings 


vill 


TABLES (Cont.) 


RSTS/E TTYSET Error Messages 

Control Characters Requiring Fills 

QUOLST Column Headings 

Summary of EDIT Program Commands 
BACKUP Input File Specification Elements 
BACKUP Options for General Usage 
BACKUP Options for Privileged Accounts 
QUE Program Commands 

QUE Job Output Options 

Q Command Options 

QUE Error Messages and Codes 

Batch Commands - Related Default File Types 
File Specification Defaults 

DIRECT Options 

DIRECT Program Error Messages 

General Input Defaults 

Output Defaults for Transfer and Directory Commands 
Input Defaults for Transfer and Directory Operations 
Additional Extended PIP Options 

Possible ANSI Magtape Transfers 

Effect of Labeling Default Assignments 

Card Reader Controls 

Line Printer Controls 

DECtape Controls 

Magtape Transport Controls 

Magtape Transport Indicators 

FILL Characters Required for VT05 

VT05 Controls and Switches 

2741 Transmission Code Identifiers 

DECwriter | Operator Controls 


PREFACE 


This manual contains information concerning operating characteristics of RSTS-I1 while 
running under Version 4 (RSTS), or Versions 5 and 6 (RSTS/E). The manual deals with the 
interaction between the user and the RSTS-I1 terminal, describes how to enter and edit 
BASIC-PLUS programs, explains system commands and system programs, and tells how to 


operate certain system hardware. For more information on RSTS/E documentation, consult 


the RSTS/E Documentation Directory. 


e following versions of RSTS-i1 operating systems released on 
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the dates shown, 


RSTS V4A-12 October 1972 
RSTS/E V@5-21 July 1973 
RSTS/E V@5B-24 September 1974 
RSTS/E V@5C-@1 February 1975 
RSTS V@4B-17 July 1975 
RSTS/E VO6A-@2 July 1975 


Features not included on certain versions are indicated by footnotes in the text. To 
determine the version of a given system, simply type the HELLO command after which 
the LOGIN program runs and prints the system identification line. The first item on 
the line is one of the version numbers described above. On systems which print other 
than RSTS version numbers, the user must consult the system manager for the correct 


version number. 


xi 


CHAPTER 1 
INTRODUCTION TO RSTS-11 


RSTS-11 (Resource Sharing Timesharing System for the PDP~] 1/20, PDP-11/40, PDP-11/45 
and PDP-11/70 computers) is a powerful timesharing system that, with sufficient hardware, can 
support up fo 64 interactive terminals. From each terminal a user has access to any peripheral 


device on the system. 


RSTS-11 uses the BASIC-PLUS language, an enriched version of the BASIC language as 
originally developed at Dartmouth College. BASIC-PLUS is compatible with existing BASIC 
programs and includes facilities to handle strings, matrices, and files. Also, COBOL is 


optionally available under RSTS/E. 


1.1 TIMESHARING 


Early computers were the province of the mathematician. Used mainly to solve differen- 
tial equations, the systems were narrow in scope and poorly utilized. Since few persons were 
knowledgeable enough to employ the enormous processors, one individual could monopolize 


computer time -~ sit at the console and solve problems in step-by-step fashion. 


As more people discovered comput ing techniques, it was no longer practical to let a few 
persons monopolize computer time. To increase machine efficiency, batch processing was 
introduced. In this mode of operation, no time was wasted between jobs. Programs were 
punched on cards and the cards stacked and fed to the computer in batches. Operation of each 


program was governed by control cards that took the place of the human operator. 


Since card reading is a relatively slow process, some early systems employed a small 
computer to read the cards and transfer program information to magnetic tape that was then 
input to the large computer. Asa further refinement, programs were assigned priorities, with 


short jobs being executed first to minimize job turnaround. 


But what about the computer user? As computer utilization improved, program develop- 
ment took more time. To develop a new program, a user performed the following procedure. 
After writing the program on paper, he carried it to a keypunch operator to have the cards 
punched and verified. A day or so later, when the program was returned, the user checked 


for punching errors, then returned to the keypunch for corrections. 


Next, he sent the cards to the computer center for compilation. The compilation, which 
might not be returned for a half day or more, could reveal spelling or syntactical errors, The 
cards then had to be changed and resubmitted -- another half day's wait. If the next 
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compilation was successful and the program was run, program logic errors might be discovered -- new 
cards, new compilation, etc., etc. In addition, the user often studied reams of computer 
listings to find the errors. Using these inefficient methods, even simple programs might take 


weeks to develop. 


Batch processing maximizes machine efficiency in routine data processing operations where 
turnaround is not critical. But for program development and modification, the user requires 
another mode of operation, The user needs a way to "interact" with the computer -~ to feed 


his program to the system, line by line, and continuously check the results. 


In fact, the user may want to develop interactive programs. These programs, which are 


extremely productive tools, ask the user questions and perform an analysis based on his answers. 


If the user had unlimited funds, he might be tempted to buy or lease a large computer -- a 
system he could dedicate to his work that would provide sufficient power, many peripherals, and 
a large variety of software. With such a system, he could develop programs interactively 
or utilize batch processing for routine tasks. | However, costs normally preclude the dedication 


of a large system to a single user. 


By using timesharing, the user has most of the benefits of a dedicated system at a smal] 
fraction of the cost. Timesharing with today's technology allows a large powerful computer 
such as a PDP-11/70 to handle 16, 32, or more users simultaneously. Through a choice of 
terminals, the user can interact with the system or initiate batch processing which runs con- 
currently. The user also has access to a choice of mass storage and peripherals and a selection 
of application programs. Since response is fast, the user appears to have a dedicated system. 
Yet costs are shared. He pays only for the time and facilities that he requires and doesn't 


pay for the time the machine is idle. 


A timesharing system isn't just any computer with some additional hardware and software. 
It's a system designed specifically for timesharing. Otherwise, facilities are limited, fewer 


users can be handled efficiently, and economics are unattractive. 


In a simple timesharing system, each program is assigned a fixed time slice or time 
quantum and operation is switched from one program to another in round robin fashion until 
each program is completed. Essentially, if each user receives 1/60 of a second and 12 users 


are "on" the system, each user will receive service every 1/5 of a second. 


The timesharing system performs multiprogramming; that is, it allows several programs to 
reside in core simultaneously and to operate sequentially. The switching between programs is 


initiated by a clock which interrupts the central processor to signal that a certain time period 
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has elapsed. A monitor, also called an operating system or executive program, directs the 


execution of these tasks and performs other duties. 


The system discussed so far services a number of users sequentially in round robin fashion. 
To increase the number of users serviced, more main memory or core is required. However, since 
core is expensive, a secondary memory is employed. This memory -- usually magnetic disk or 
drum -- is slower than core or main memory but provides greatly increased capacity at reasonable 
cost. User programs can be located in secondary memory and moved into main memory for 
execution. Programs entering main memory exchange places with a program (or programs) that 


has just been serviced by the central processor. This operation is called swapping’ 


In operation, main memory is divided into separate memory blocks. Secondary memory 
is connected to these blocks through a high speed input/output processor -- a hardware device 
that allows the disk or drum to swap a program into any one of the main memory blocks without 
any aid from the central processor. This structure allows the central processor to be operating 
a user program in one block of memory while programs are being swapped to and from another 
block. This independent overlapped operation greatly improves efficiency and processing 


power. 


Round robin scheduling, in which each program operates in sequence and receives a fixed 
amount of time, is effective only if all programs have similar requirements. Such is not the 
case, however. At any particular time, a timesharing system will be handling some programs 
which require extensive amounts of computing time (and are said to be compute bound) and 


other programs that must stop frequently for input or output (I/O bound). 


To serve programs at and between these two extremes, the scheduling algorithm must 
provide frequent service to I/O bound programs and must give compute bound jobs longer time 
quantums to prevent wasteful swapping. A simple dynamic scheme could provide two 
queues ~~ one for each type of job. When a user first logs on to the system, he is placed in 
an I/O bound queve (waiting line) where he receives frequent service and small time quantums. 
If the program isn't completed or does not request input or output during the time allotted to 
him, the job needs more computing time and is placed in the compute bound queue. Thus the 
scheduling algorithm optimizes system efficiency by automatically adjusting to program 


requirements. 


In the present state of scheduling art, algorithms are constantly being changed and im- 
proved. Current algorithms are extremely sophisticated, providing excellent service for most 


timesharing job mixes. They also allow fine tuning, if such modifications are necessary. 


The ability of the algorithm to match processing to program requirements ensures the best service 


possible for all user programs. 


A timesharing system has performed its basic function if it allows a number of users 
simultaneous access to a central computer. However, to be fully useful, the system should 
also allow the users access to other system resources -- storage devices for his programs and data, 
line printers, card readers, etc. For example, the user should be able to choose between 
magnetic tape and disk for program storage. And if he has a 50-page report to produce, he 
should be able to employ a line printer instead of his terminal. If users controlled these 
devices, however, much confusion might result. For example, two users might select the line 
printer at the same time. If one user was processing Abraham Lincoln's Gettysburgh Address 


and another Mark Anthony's funeral oration, the report might look like the following: 


| COME TO BURY CAESAR NOT TO PRAISE HIM 

FOUR SCORE AND SEVEN YEARS AGO 

THE EVIL THAT MEN DO LIVE AFTER THEM 

OUR FATHERS BROUGHT FORTH ON THIS CONTINENT 


To prevent users from interfering with each other, the monitor coordinates input and output 


(I/O). 


The user can request that a particular device be assigned for his use, and release the 
device upon completion of an operation. During this time no other user can perform 1/O to 
an assigned device. If the user does not specifically assign a device but attempts to use it, 
he is given access to the device if it is not already assigned to another user or currently being 


used. 


If a user does not require a fast device for his exclusive use (like a private disk), he can 
elect to use a public device, such as the public disk area, line printer, paper tape devices, 


etc. 


User programs and data can coexist on the same storage device. A filing system is 


necessary if program and data segments are to be retrieved in proper order. 


Data is transferred from memory to a peripheral device as a block of words or a record. 
(A word is the number of binary digits or bits that the central processor can retrieve and 
"operate on" at one time.) Record length can be arbitrary or dictated by the physical device 
being used, for example, the number of columns on an 80 column card or ona 132 column line 
printer. For PDP-11 disk files, the normal length is 256 words. This can be altered with 
the RSTS-11 Record |/O features. 


For convenience each user's blocks are organized in groups called files. Files, like 
memory, must be protected from access by unauthorized users. When a user creates a file, he 
can restrict it, specifying whether others can have access, and (if access is permitted) whether 
the files can be modified or only read. With such an arrangement, programmers in various 
locations can use the same data to work simultaneously on the same project; but unauthorized 


personnel cannot modify or read the files. 


Users can communicate with the computer over the conventional dial-up telephone net- 
work. User terminals can, therefore, be located anywhere that phone service is available and 


be connected to any computer system, feasibility limited only by long distance phone rates. 


Each user terminal is connected to a data set or modem (modulator-demodulator) which 
converts user terminal output into a signal suitable for the telephone network. At the computer 
end of the phone lines, there is another data set which reconverts the signal and feeds it to the 


central processor. 


The number of data sets employed at the user end of the system is unlimited. At the 
computer end of the communications network, however, the number of data sets is limited by 


the number of users that can be serviced simultaneously by the system. 


In order to gain access to the system, the user dials the system phone number from his 
data set. The telephone network handles the call, scanning the data sets at the computer 
system. If all of the sets are busy, the user receives a busy signal, just as he would with 
normal phone service. If a set is available, the telephone network rings it, and the computer 
answers the call, placing the user in communication with the monitor. The terminal is then 


on-line and ready for operation. 


1.2 USING RSTS-11 


The remainder of this document describes how to use the RSTS-11 system from the user 
terminal. The user may issue commands to the RSTS-11 monitor (Chapter 2) or use any of the 
system programs available in the system library (Chapter 4). Chapter 5 describes the manual 
operation of typical RSTS-11 peripheral devices. 


For information on the BASIC-PLUS language, the user is referred to the BASIC-PLUS 
Language Manual. The appendices to this document summarize the language elements as 


well as other information such as commands and error messages. 


CHAPTER 2 
RSTS-11 SYSTEM COMMANDS 


2.1 ON-LINE WITH RSTS-11 
2.1.1  Project~Programmer Numbers and Passwords 


Before the user attempts to use the RSTS-11 system, the system manager will assign him a 
unique project-programmer number and password. The project-programmer number might, for 


example, look as follows: 


[igg , 191] 


The number 19% above is the project number (possibly held by a group of people having a common 
interest) ; and the number 11 is the programmer number (held by only one person within the 
project group). Thus, each individual's project-programmer number is different. The project- 
programmer number is also called the user's account number. Protection codes are assigned to 
user files on the basis of the various relationships among users as determined by the components 


of their account numbers (see section 2.4.4 describing the NAME-AS statement). 


The user password is a unique alphanumeric code assigned to an individual user. This 
password is never printed on the terminal and, hence, allows for a measure of security in limiting 


the use of the computer system. 
2.1.2 Getting On-Line, HELLO Command 


Equipped with the codes to obtain access to the system, the user should find a terminal and 
turn the LINE-OFF-LOCAL igeb to LINE. This puts the terminal on-line to RSTS-1I1, that is, 


opens a line of communication between the computer and the terminal. 
Once the terminal is on-line, type the command: 
HELLO 


followed by the RETURN key. This tells RSTS-11 that a user wishes to join the system. RSTS-11 
responds by printing a system identification message, then prints a number sign (#) at the left 
margin of the paper, and then waits for the user to type his project-programmer number (followed 


by the RETURN key). The system responds by printing: 
PASSWORD: 


and then waits for the user to type his password followed by the RETURN key. The password 


1 
Alternate types of user terminals may have a different knob or switch designed to put the 
device on-line. See Chapter 5 for information concerning other devices. 
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characters are not printed at the console. If the codes are acceptable to the system, the user 
is logged into the system. A message specified by the system manager is then printed. This 
message generally changes from day to day and provides the user with information on any changes 


or additions to the system. 
If the codes entered are incorrect, the message 
INVALID ENTRY - TRY AGAIN 
is printed and the user can try again. 


The entire process of entering the system is shown below (although the RETURN key is typed 
to enter a line to the system, it does not echo on the terminal paper except to perform a carriage 
return/line feed operation). Characters printed by the system are underlined to differentiate 


them from characters typed by the user. 


HELLO 
RSTS VO6A-4 SYSTEM #880 JOR 16 KBié @2-JUN-7S  B4:6 FM 
#120, 68 


WE HAVE INSTALLEO A NEM RP G4 DISK ON DRIVE #1. WE ARE 
ATTEMPTING TO RESTORE DRIVE #1 FILES AS OF MAY 25... 


REAGY 


Once the user is successfully logged onto the system, the READY message is printed. The system 
prints READY to indicate that the terminal is at BASIC-PLUS command level, The user can type 
NEW to create a new program, OLD to retrieve a program previously saved, or any other RSTS-11 


command, J 


An alternate way of logging into the system is to enter the project-programmer numbers on 
the same line with the HELLO command, as shown below. This results in the system prompting 


the typing of the password only. 


lon Version 4 (RSTS) systems, the message NEW OR OLD is printed once the user is successfully 
logged onto the system. However, the user can type any RSTS-11 command. 
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HELLO 126, &6 
PASSNORE : 


RSTS TIMESHARING HOURS ARE: 


S:36 AM To 6:68 FM MONDAY THRU FRICFY 


Note that, on Version 4 (RSTS) systems, LOGIN prints the system identification message before 
printing PASSWORD, 


Another option available when logging into the system is the use of the slash character 
rather than the comma to separate the project and programmer numbers. The slash character 
inhibits the opening message (s) printed by the system. Such messages are installed on the system 
by the system manager and generally contain useful information. However, when logging into 
the same system several times in one day, it is frequently desirable to eliminate the time neces- 


sary to print a message the user has seen previously. 


HELLO 126-86 
PASSWORD: 


2.1.3 Going Off-Line, BYE Command 


When the user is ready to leave the terminal, he types the command: 


BYE 


followed by the RETURN key. This tells RSTS-11 that the user has requested to be dismissed 
from the system. At this point RSTS-11 prints 


CONFIRM: 


and waits for the user to give one of the following replies: 
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CONFIRM: 
Reply 


N 


Meaning 


No. The logout sequence is terminated, the user is not 
logged out, and the system again replies READY. 


Individual. The user wishes to individually examine each of 
his files. The system prints the name of each user file on the 
system disk, its size, protection code and creation date, 
followed by a ? character, The user can reply by typing K 
to kill (delete) the file or type the RETURN key to retain 
the file. (Any reply other than K causes the file to be 
retained.) 


Causes the system to print an explanation of the possible 
CONFIRM: replies. 


Yes. The system attempts to proceed with the logout se- 
quence, checking to see that the user has not exceeded the 
disk quota for his project-programmer number. If the user 
has used more than his share of disk storage, an appropriate 
message is printed and he is not allowed to leave the system 
until he is within his disk quota. 


Fast logout. Same as Y except that the accounting messages 
are not printed. ! 


The following is the simplest case in which the user simply logs off the system. 


BYE 
COMFIRM: ¥ 


SAVED ALL DISK 


FILES: 288 BLUCKS IN USE, 166 FREE 


JOG 16 USER 128,86 LOGGED OFF KEIS AT 15-AuUG-"4 fe: ee FM 
SYSTEM RESTS VASB-od SYSTEM #ES8 


RUN TIME WAS 


» SECONDS 


ELAPSEOG TIME WAS PF MINUTES, SS SECONDS 


GOOG AFTERNOG? 


The following example demonstrates the ? and N replies: 


BYE 
CONFIRM: ? 
GFTIONS FOR “CONFIRM: ARE: 
? THIS HELF MESSAGE 
N DON’T LOG ME GUT 
I INGIVIDUAL FILE DELETION 
K TG DELETE 
<CR2 TO SAVE 
F FAST LOGOUT 


CONFIRM: W 


READY 


Vanie feature is not available prior to Version 5 (RSTS/E) systems. 
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The following example shows the sequence in which the user is over his disk quota; deletes 


some files, and then logs out of the system: 


BYE Y 

DISK QUOTA GF 40@ EXCEEDEO BY Se BLOCKS 

SOME FILEcS> MUST BE DELETED BEFORE LOGGING CULT 
TYPE “27° FOR HELP 


CONFIRM: I 
A BAS 150 6a 15-AUIG-74 7 
c _ BAS 150 6a 1S-AlG-?4 + 


B _BAS 156 68 15-AG-F4 oF K 

TYRE “7° FOR HELP 

CONFIRM: ¥ 

SAVEOG ALL DISK FILES: 368 BLOCKS IN USE, 168 FREE 

JOE 16 USER 126,66 LOGGED OFF KE1AS AT 15-AUG-74 B3:34 PM 
SYSTEM RSTS VASb-24d SYSTEM #058 

BUN TINE NAS 2.2 SECONDS 

ELAPSED TIME WAS = MINUTES, 2 SECONDS 

GOOG AFTERNCGOGN 


Upon logging the user out of the system, RSTS~11 deletes, from the disk, any temporary 
files which have been created by the system for the user. Any files created by the user and 


still remaining open on disk (or any I/O device) are closed and saved for future reference. 


Before leaving the terminal, the user should turn the LINE-OFF-LOCAL knob! to OFF, 
(Turning the knob to LOCAL means that the terminal has power, but is not connected to the 


system. It then operates as a typewriter.) 


2.1.4 Commands That Can Be Given Without Logging into the System 


As long as the RSTS-11 system is in operation, anyone can turn a terminal on-line and 


give one of the commands described in Table 2-1. 


Any of the commands in Table 2-1 can be issued from a terminal prior to logging into the 
system, although the full capabilities of the system program may only be available to a user 
already logged into the system. For details, see the appropriate section on the individual 


system program. 


Lsoins any other terminal being used should be turned off-line and powered down when 
not in use. 
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Table 2-1 
Logged-Out RSTS-11 Commands 


Causes a text file to be output to the user terminal explain- 
ing how to log into the system and various system features. 


Causes the system to output a system status report to the user 
terminal, using the SYSTAT system program. See section 4.3. 


Allows the user to set the characteristics of the user terminal, 
using the TTYSET system program. xxxx is one of the accep- 
table TTYSET arguments, see section 4.5. 


Allows the user to enter the system. Requires the knowledge 
of a legal account number set and the associated password. 
Causes the LOGIN system program to be run, see section 4.1. 


QUE /L dev: Prints a listing of the jobs in the queue for the specified 
spooling programs. If device is not specified, the queue 
listing of LP@: is printed. 


2.2 CREATING A BASIC-PLUS PROGRAM 
2.2.1 NEW Command 
In order to create a new user program, the user issues the NEW command: 
NEw 
followed by the RETURN key. The system responds by printing: 


NEW FILE NAME-- 


to which the user responds by typing the name of the new program, No filename extension is 


required (or accepted) at this point. The SAVE and COMPILE commands automatically append 


the correct filename extension. 
Alternatively, the user can give the NEW command followed by the program name, to 
avoid having the system prompt typing of the program name. The command: 
NEW PROG 
is equivalent to the sequence: 


NEW 
NEW FILE NAME-- PROG 


When the NEW command sequence is entered to the system, it: 


a. Deletes any program currently in memory, and 
b. Causes RSTS=11 to store the new program name. 


The command of the form: 
NEW DT@:BOGLE 


is meaningless. New programs are input from the user terminal only. The OLD command is used 
to input programs from other devices, No system check is made of an existing file of the name 
given in the NEW command. All checking for duplicate file names occurs when the SAVE com- 


mand is given. 


The user has the option of typing the RETURN key instead of indicating a filename. This 
causes RSTS-11 to create a file called NONAME which can be saved or compiled and referenced 
later as NONAME,BAS or NONAME, BAC. This name can be changed at any time (see sec- 
tions 2.2.3 and 2.4.3). The creation of the file NONAME is shown below (the RETURN key, 
although typed, does not echo): 


NEW 
NEW FILE NAME-- 


READY 


If the SAVE command is issued at this point, it will create the file NONAME. BAS, 


2.2.2 Input of the New Program 


Once the NEW command has been given and a new file created in memory, the user has 
the option of typing the program into the system or entering the program from a pre-punched 


paper tape through the terminal low-speed reader. ! 


If the user is typing his program into the system, he will likely want to use the RSTS-11 
editing features (section 2.2.3) and the LIST and DELETE commands (sections 2.2.4 and 2.2.5). 


Information on how to use the low-speed terminal reader is found in sections 2.6.1 and 5.1.4. 


IThe ASR-33 Teletype terminal has a low-speed punched paper tape reader. RSTS-11 considers 


input from the Teletype paper tape reader equivalent to input from the terminal keyboard. 


2.2.3 Editing BASIC-PLUS Programs 


While typing a program at the terminal, or after a source program is brought into memory 
or run, changes can be made in the source program text. These changes are made in what is 
called the editing phase of BASIC, between the time when the system prints READY and the time 
when the user types RUN. (During this phase, system commands and immediate mode statements 


can be executed.) 


The simplest type of correction is done during the typing of a line, before the line is 


entered to the system with the RETURN key. For example: 
18 DEF FUN(X) 


If the user realizes that he has typedF UN instead of FNU, he can type the RUBOUT key once 
for each character to be erased. The RUBOUT key causes the erased character to be echoed on 


the user terminal between backslashes as they are erased. For example: 

1@ DEF FUN(X <Rubout ><Rubout ><Rubout ><Rubout> NU (X)=X* 2*X/2 + x/2 
Typing the above is printed on the terminal as follows: 

1@ DEF FUNCX\XCNUNNUCX) =Xt2*X/2+%/2 


If the RETURN key is typed at the end of the above line, the system would receive it as follows: 


1@ DEF FNUCK)=Xt2@*X/2+X/2 


Frequently it is easier to delete the entire line, rather than type the RUBOUT key several times. 
If the user has not yet entered the line to RSTS-11 with the RETURN key, he can type CTRL/U 
(see section 3.6 ), which erases the entire current physical line. If the RETURN key has been 
typed, the line can be retyped, and the second version will replace the first in the computer 


memory. For example: 


20 LET X 
20 LET X 


"AaBCT 
"ABC" 


b 
& 
2 
fw fo 
ee 
DD 
" 


‘2@-E1 3 BS 
20-01 : BS 


wot 
pe 
(#1) 
e 


If these two lines are typed in succession, only the second line is retained by the system. 
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2.2.4 LIST Command 
The LIST command is used to obtain a clean printed copy of all or part of the user's current 
program at the user terminal. This is especially useful during and after an editing session in 


which the original program is changed. 


In order to obtain a printed copy of the entire program as it currently exists within the 


system, type: 
i 


LIS 


When listing the whole program, source lines are printed in line number sequence regard- 
less of the order in which the lines were entered. In order to list a single line, type LIST follow~ 


ed by the line number. 


LIST 166 


obtains a printed copy of line 100. 


In order to list a section of the program, type LIST followed by two line numbers separated 
by a dash, 


LIST 188 - 200 


lists all program lines from line number 186 to line number 2Q@, inclusive. If 148 and/or 266 
do not exist in the program, any lines within the range 108 to 20 are listed. 


One or more single lines or program sections can be specified in a single LIST command 


by separating the individual elements with commas. For example: 


LIST 25, 3, 58-75, 95, 166-150 


causes single lines 25, 36, and 95 to be printed along with the program lines between 50 and 75 
and between 18% and 158 . Lines or program sections need not be indicated in sequential order 


in the LIST command, but the printed lines appear in the order requested. 


In each of the previous examples, BASIC prints a program header containing the program name 


and the current system date and time. If this header material is not desired (as it might not be 
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during normal editing), the command may be given as LISTNH to delete the header material. To 


summarize: 

LIST Command Meaning 

LIST List the entire user program as it currently exists. 

LISTNH Same as LIST, but without the program header. 

LIST n List line n. 

LISTNH n List line n without the program header. 

LIST n1-n2 List lines n] through n2, inclusive 

LISTNH niI-n2 List lines n1 through n2, inclusive, without the program header. 


Extensive examples of program listings are shown in the BASIC-PLUS Language Manual. 
In listing a program, the ? character is printed at the left of each line which RSTS-11 


considers to be in error. For example: 


LISTNH 
1@ LET A.B = 25 
2260 PPRINT A+B 


The LIST command sends output to the user terminal only. If a line printer is available on 


the system, 
SAVE LP: . 
is the fastest way to obtain a complete program listing. (See Section 2.4.1.) 


2.2.5 DELETE Command 
The DELETE command is used to remove one or more lines from the current user program. 


For example: 


DELETE 168 


causes line number 186 to be deleted. 


DELETE 180 - 260 


causes all program lines between and including line numbers 18% and 286 to be deleted. If 18¢ 
and/or 26 do not exist in the program, any lines within the range from 186 to 2@@ are deleted. 
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If several lines or groups of lines are to be deleted, the user can separate the individual 


elements with commas, as follows: 


DELETE 180-268, 255, 300-486, 476, 1900-1108, 475 


which deletes all lines between 180 and 260, line 255, lines 30 to 408, lines 476 and 475, 
and lines 1808 to 118. Lines or program segments to be deleted need not be listed in sequential 
order in the DELETE command. 


If only one line is to be deleted, it may be more convenient merely to type the line number 
and the RETURN key as follows: 


1p 


which is equivalent to: 
DELETE 18 


Before deleting any line, the user should be certain that no other line references the de- 
leted line (such as a GOTO statement), unless the deleted line is to be replaced. A reference 


to a missing line number will generate an error message when the program is run, halting execution. 


If all lines from the current program are to be deleted, type the DELETE command without 
a number. Remember: typing the DELETE command without specifying a line number deletes 
all lines of the current program 
2.2.6 RENAME Command 

The RENAME command causes the name of the program currently in core to be changed to 


the specified name. For example: 
RENAME NEWNAM 


The old name of the program currently in memory is discarded, The current program is now known 


as NEWNAM, If the SAVE command is given at this point: 
SAVE 


the file NEWNAM.BAS is stored on the system disk. 


2.2.7 Debugging BASIC-PLUS Programs 


The phase of program development during which the user is testing the program is called 
the debugging phase . Rather than repeatedly executing the program with minor alterations on 
each cycle, debugging can be facilitated by placing STOP statements at strategic places 
throughout the program. When the program is executed, each STOP statement causes a program 


halt, and the message: 
STOP AT LINE 56 


is printed. In the above case, the STOP statement was located at line 50. The user at a RSTS-11 


terminal can then use immediate mode instructions to examine and/or change data values. 


Issuing the CONT command causes program execution to continue at the next statement 


following the last STOP statement executed. 


Once a program is successfully debugged, the extraneous STOP statements can be removed 


with the DELETE command. 


Typing CTRL/C (see Section 3.5) also causes program execution to halt, but there is less 
control over where the program halts. The system prints READY and the CONT command can be 
issued. In this case the program may or may not be able to continue depending upon the program 
status when the CTRL/C was entered. On some systems, the variable LINE contains the line num- 
ber of the statement being executed when the program halts. See Chapter 4 of the BASIC-PLUS 


Language Manual for more information on program debugging and interruption. 


When debugging a program with considerable amounts of terminal output, CTRL/O can be 


used as a switch to stop and restart such output (see Section 3,7). 
2.2.8 CONT Command 


As explained in Section 2.2.7, the STOP statement and CTRL/C can be used to cause 
execution halts in a user program. Immediate mode examination of values or changes can then 
be performed, and the program restarted at the statement following the last executed statement 


by giving the 
CONT 


command, followed by the RETURN key. When the CONT command is entered, the system 
attempts to continue program execution whenever possible, (This is also true of program halts 
due to execution errors. Following the printing of some error messages, the CONT command may 


cause program execution to be resumed.) If it is not possible to continue program execution for 
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any reason the 
CAN'T CONTINUE 


message is printed. In almost all cases, it is possible to continue program execution once a 


CTRL/C or STOP command is executed. 


2.2.9 CCONT Command 


The CCONT command performs the same actions as the CONT command but additionally 
detaches the job. This command is useful for continuing a lengthy job that does not involve 
further terminal interaction, The CCONT command is available only to privileged users. An 
attempt by a non-privileged user to use the CCONT command results in the ILLEGAL SYS() 


USAGE message. To continue, the non-privileged user must use the CONT command. 
2.3 EXECUTING A BASIC-PLUS PROGRAM 


2.3.1 RUN Command 


The RUN command is used to cause the execution of any source or compiled BASIC-PLUS 
program under RSTS-11, (Source programs are stored as typed by the user; compiled programs 


are described in Section 2.3.3.) 
In order to run the program currently in memory, the user simply types: 
RUN 


This causes the execution of the program. A program header is printed after the RUN 
command is given, consisting of the program name and the current system date and time. If 


this information is not desired, the command: 
RUNNH 


should be given. RUNNH executes the current program without printing the header material. 
Any characters or filename specified in the RUNNH command are ignored; only the program 


currently in memory is run, 
Where it is desired to run a program not currently in memory, the command: 


RUN FILEV3 


can be given. This command causes RSTS-11 to search for the file FILEV3.BAC or FILEV3.BAS 
on the system disk; load, compile (if necessary), and run it (if the file is found). (Since blanks 
are not significant in BASIC-PLUS commands, the RUN filename command does not execute 

properly if the first two characters of the filename are NH. For example, RUN NHTAX results 


in the execution of a RUNNH command, and the program currently in memory is run.) 


If FILEV3.BAS (source) and FILEV3.BAC (compiled) both exist, RSTS-11 loads and executes 
FILEV3.BAC since it requires less time. In order to retrieve and execute FILEV3.BAS, it is 
necessary to issue separate OLD and RUN commands. The file is then available for any editing 


to be performed. 

If FILEV3.BAS exists but FILEV3.BAC does not, then the command 
RUN FILEV3 

loads, compiles and executes FILEV3.BAS. 


Where the file to be run is not present on the system disk, but is stored on another device, 


the format: 
RUN dev:FILNAM 

is used where dev: is the designation of the storage device. For example: 
RUN DTI: TRANS 

which runs the file TRANS.BAS found on DECtape unit 1. The statement: 
RUN PR: 


reads a BASIC program from the high speed reader and runs it. Since PR: is an input-only 


(non-file structured) device, no filename need be specified. 


If a filename is specified with a non-file structured device in the RUN command, that 
filename is used as the current program name when the program is read into memory. For 


example: 


RUN PR: ABC 
6.12345 


READY 


The program is read from the high speed reader and run. It is assigned the name ABC. However, 
if no filename is specified, the file in memory will have no name. A SAVE command or any 
other command without a filename cannot be issued without assigning a name to that file (see 


the RENAME command, Section 2.2.6). For example: 


RUN PR: 
9.12345 


READY 


SAVE 
ILLEGAL FILE NAME 


READY 
A filename must be used in the SAVE command or the program in memory must be given a name. 
2.3.2 Program Segmenting, CHAIN Statement 


If a user program is too large to be loaded into core and run in one operation, the user 
can segment the program into two or more separate programs. Each program is assigned a 
distinct name; control can be transferred from one program to another with the CHAIN statement 


used as part of a program or in immediate mode, 
The immediate mode form of the CHAIN statement is: 
CHAIN < string>{<line number>} 


in which <string> is the filename specification of the next program segment and <Zine nwnber> 
specifies the line number in the new program segment at which to begin execution. If no 


line number is specified, execution begins with the lowest numbered line. For example: 
CHAIN "PHASE2" 20 


causes the program file PHASE2 to be executed. Execution begins with line 20 in the file 
PHASE2, The CHAIN command first searches for the file PHASE2.BAC and if that search 
fails, will search for PHASE2.BAS. A device specification and/or project-programmer number 


can be included in the filename specification string. 


Communication between various program segments can be achieved by means of the user's 


file area (see the discussion of virtual array files in the BASIC-PLUS Language Manual). 
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When the CHAIN statement is executed, all currently open files are closed, the new 
program is loaded, and execution continues. The CHAIN command is similar to the RUN 


command with the additional capability of specifying a starting line number. 
2.3.3 COMPILE Command 


Normally, RSTS-11 accepts each line of the user program as it is entered and, if the line 
is syntactically correct, translates the line into a form understood by the RSTS-11 Run Time 
System. (The BASIC-PLUS Compiler produces an intermediate code which jis then interpreted 
by the Run Time System.) As the program is edited, only those lines which are changed are 
recompiled (i.e., translated), When the SAVE command is given, only the source version of 
the program (i.e., text that is typed in response to the LIST command) is stored in the .BAS 
file created. In response to the OLD command, BASIC reads the text from the saved file and 


compiles it in the same manner as when the program is entered from the user keyboard. 


Once a program is completely developed and debugged, it may be desirable to avoid the 
time-consuming practice of compiling the program every time it is brought into memory. For 
this reason, the COMPILE command has been provided. COMPILE permits the user to save an 
image of his compiled program, rather than (or in addition to) the source text of the program. 
This compiled version of the program is stored with the filename extension .BAC and can be 


read from the system device and executed with a minimum of overhead. (See Section 2.3.1.) 


NOTE 


Compiled files have a minimum size requirement 
of 11 blocks. This size may be greater than 
necessary to actually store the compiled (or 
even source) version of a short program. In such 
cases the user should be aware that he is trading 
disk space for execution speed. 
Due to the transformation that takes place when a program is compiled, a file with the 
extension .BAC can only be executed; it cannot be edited. Therefore, the user can issue the 


RUN command with respect to compiled files, but the file cannot be retrieved with the OLD 


command, 


If the current filename (i.e., that which is typed as part of the header listing) is FILE@I, 


then the command: 


COMPILE 
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saves the compiled program in a file named FILE@1 .BAC on the system disk. If another name is 


desired for the compiled file, it can be specified. For example: 
COMPILE PROG 


generates a file PROG .BAC on the system disk. Compiled programs are output only to the 
system disk.! The COMPILE command causes the filename extension .BAC to be appended to 
the current or specified filename for storage in the user's disk library. Compiled files are 
stored with a default protection of <124>. The default protection <124 >consists of the 
compiled file protection <64> plus the system-assigned 


POTrCarOon s 


o obtain 


be explicitly specified as in the following example. 
COMPILE <4@ > 


The above command creates a file on the system disk having the current filename, a .BAC 
extension, and an assigned protection code of <104 >, which consists of the user-specified 
protection <4@> and the compiled file protection <64>. At any time a protection code 
can be altered with the NAME-AS command or with the rename facility of the PIP system 


program 2 
2.4 PROGRAM FILE MANIPULATION 
2.4.1 SAVE Command 


The SAVE command is used to store BASIC-PLUS source programs on the disk as 


follows: 
SAVE 


The program currently in memory is saved on the system disk under its current filename with 


the extension .BAS. Ifa file of the same name exists, the system returns the error message:9 


FILE EXISTS-RENAME/REPLACE 
My privileged user can obtain a copy of a compiled file on another device, using the PIP 
system program, 
20n Version 4 (RSTS) systems, the compiled file protection <64> is not used. On Version 5 
(RSTS/E) systems, the user can execute the ASSIGN command to alter the protection code 
assigned by the system (see Section 2.7.3). 


Veion 4 (RSTS) systems print the message in shorter form: FILE EXISTS-USE REPLACE. 
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This message is designed to protect the user against inadvertently destroying an existing 
file. The user can designate a unique name for the file using the SAVE command or can change 


the current version of the file on the system disk using the REPLACE command. 
For example, if the current filename is not the desired name, the format: 
SAVE FILNAM 


can be used, which saves the program currently in memory on the system disk under the name 
FILNAM.BAS. The name of the current source program is not stored in memory with an 
extension (no extension is printed as part of the current filename when a LIST command is 
given). The SAVE command appends the .BAS extension when writing the file to a storage 


device. 
In cases where the desired storage device is not the system disk, the format: 
SAVE dev: 
or: 
SAV dev:FILNAM 


is used where dev: indicates a device designation. The file is stored as the current filename 


or as FILNAM.BAS on the indicated device. For example: 
SAVE DT@:ROPE 
saves a copy of the program in memory as the file ROPE.BAS on DECtape unit @. 


The SAVE command is usable only when a source file is currently in memory. When a 


program is saved, it is still in the computer memory and can be run, changed, or deleted. 
To obtain a listing of the current source program on the line printer, the user can type: 
SAVE LP: 


To punch a tape of the current source program on the high-speed paper tape punch, the user 


can type: 
SAVE PP: 


No filename specification is needed with an output-only (non-file structured) device. 
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To punch a tape on the low-speed punch, give a LISTNH command, turning the punch on- 
line before typing the RETURN key. This is not recommended as the word READY is punched at 
the end of the tape. Tapes punched on the low-speed punch should be read only through the 


low-speed reader. 


2.4.2 Recalling a Saved Program, OLD Command 


is issued as follows: 
OLD 

to which the system replies: 
OLD FILE NAME-- 


The user then types the name of the saved BASIC -PLUS file containing the program. Alternative- 


ly, the user can indicate the old filename without prompting, as follows: 
OLD TAXES 


which calls the saved file TAXES,BAS from the system disk. If the file is not available on the 


disk or if it is protected against the user, an appropriate message is printed. 


Where no filename is indicated, RSTS-11 looks for the file NONAME (which could have 


been created by the user or the system, see Section 2.2.1). For example: 


OLD 
OLD FILE NAME-- 


READY 


Whatever was stored in the file NONAME,BAS for the current user on the system disk is now 


in memory and available to the user. 
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The OLD command can only retrieve BASIC-PLUS source programs, since compiled 
programs (.BAC files) can be run but not changed. BASIC-PLUS source programs have the 
default extension BAS but other extensions are allowed. Any program called with the OLD 


command can be edited by the user at the terminal. 


2.4.3 Merging Two Source Programs, APPEND Command! 


To merge the contents of a previously saved BASIC-PLUS program into a program 


currently in memory, the APPEND command is issued as follows: 
APPEND 

to which the system replies: 
OLD FILE NAME-- 


The user then types the name of the saved BASIC-PLUS source file to be appended. The file 

is read into memory and, depending upon the ordering of the source statement line numbers 

of the appended file and the program currently in memory, its contents are merged into or appended 
to the current program. If both programs contain an identical line number, the line in memory 

is replaced by the appended program line. Alternatively, the user can indicate the old file name 


without prompting, as follows: 
APPEND RUTINE 


which merges the contents of the saved file RUTINE.BAS from the system disk into the program 
currently in memory. If the file is not available on the disk or if it is protected against the 


user, an appropriate message is printed, 


When no file name is indicated, RSTS-11 looks for the file NONAME.BAS, which could 
have been created by the user or by the system. (ee Section 2.2.1 for a description of 
NONAME.BAS.) For example: 


APPEND 
OLD FILE NAME=- 


READY 


The contents of the file NONAME.BAS on the system disk for the current user are merged 


into or appended to the current program and is available to the user. 


The APPEND command can only retrieve BASIC-PLUS source programs (.BAS files), 
since compiled programs (.BAC files) can be run but not changed. Any file called with the 


APPEND command is available to the user at the terminal. 


Nha APPEND command is not available on Version 4 (RSTS) systems. 
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2.4.4 File Protection and Renaming, NAME-AS Statement 


The NAME-AS statement can be used in immediate mode to rename and/or assign protec- 


tion codes to a disk or DECtape file. The format of the command is as follows: 


NAME <string> AS <string> 
The specified file, the first <string> indicated, is renamed as the second <string> indicated. 


Where the file resides on a device other than the default device (system disk), the device 
must be specified in the first string and may optionally be specified in the second string. No 
filename extension assumptions are made by NAME-AS; the filename extension must be specified 


in both strings if any extension is present in the filename. For example: 
NAME "DT@:OLD.BAS" AS "NEW.BAS" 

is equivalent to: 
NAME "DT@:OLD.BAS" AS "DT@:NEW.BAS" 


but the statement: 


NAME "FILET.BAS" AS "FILE2" 


is not advised since FILE2 has no extension and could not subsequently be called into core 


via the OLD or RUN commands (which require filename extensions). 


A file protection code can be specified within typed angle brackets as part of the second 
string although it is not required. If a new file protection code is specified, it is reflected in 
the protection assigned to the renamed file. If no new protection code is specified, the old 
protection code is retained. See the BASIC-PLUS Language Manual for a complete description 


of protection codes. 
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NAME "FILE,EXT" AS "FILE.EXT < 46>" 
changes only the protection code of the file FILE,EXT stored on the system disk. 
NAME "DT@:ABC,.BAS" AS "XYZ,.BAS" 


changes the name of the file ABC,BAS on DECtape unit 8. Since no transfer of the file from 
one device to another can be performed with the NAME-AS statement, it is not necessary to 
mention DT@: twice; that is, the device of the new filename need not be specified. (To 


transfer a file between devices use the PIP system program.) 

NAME "NEW" AS "NEW, 1" 
changes only the extension of the disk file NEW (with no extension) to NEW.1. 
2.4.5 System Library Files 


The system library is conventionally stored under account [1,2] ona RSTS-11 
system. The CATALOG$ command can provide each user with a list of those programs 
available in the system library and their protection codes. Rather than specify the [1,2] 
account number as part of the file specification each time a system library program is refer- 
enced, the user may precede a system library filename with the $ character, which is 


synonymous with [I,J]. 


Most system library files are completely write-protected. Unless the file is also read pro- 
tected, the user can issue OLD or RUN commands with respect to system library files, 


remembering that the OLD command can only be used on a source file. For example: 


OLD$ SYSTAT 
or 


OLD $SYSTAT 


(Spaces are not significant in RSTS-11 command strings.) 


is equivalent to: 


OLD [1,2] syYSTAT.BAS 
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and is only legal where SYSTAT is stored as an available source file in the system library. The 


command: 


RUN$ SYSTAT 


will cause the file SYSTAT.BAC to be loaded and executed, if found; and, if SYSTAT.BAC 
does not exist, the file SYSTAT.BAS is loaded, compiled and executed. (Most system library 
files are .BAC files.) 


2.4.6 Removing a Saved Program, UNSAVE Command 
The UNSAVE command is used to remove a file from a storage device. The form: 
UNSAVE FILNAM, BAC 


removes the file FILNAM.BAC from the disk. (The system disk is the default device.) If the 


command is given: 
UNSAVE FILNAM 


BASIC attempts to remove the file FILNAM.BAS. Unless a filename extension is specified in 


the command, an extension of .BAS is assumed. 
To indicate an alternate storage device, the form: 
UNSAVE dev:filename. extension 
is used where dev: is the device designation. For example: 


UNSAVE DT1:FLAM 


removes the file FLAM.BAS from DECtape unit 1 if it is found. 


2.4.7 Updating a Saved Program, REPLACE Command 


The REPLACE command is used when the user wishes the program in memory to replace a 


file on the system disk with the same name. The command is of the form: 


REPLACE 
or 


REPLACE FILNAM 


2-23 


REPLACE performs the same function as SAVE, but destroys the old copy of the same file, if it 
exists, without notifying the user. REPLACE appends a .BAS filename extension to the filename 
already associated with the file or specified in the REPLACE command. Where a filename spec- 
ification is given, REPLACE replaces the file on the system disk with the name indicated. In 


this case the name of the current program, as stored in memory, is ignored. 
2.5 SYSTEM STATUS REPORTS 
2.5.1 LENGTH Command 


The LENGTH command returns the length of the user's current program. The user need 


only type: 
LENGTH 
and enter the command to the system with the RETURN key. For example: 


LENGTH 
2K _OF CORE USED 


The size of the current program is reported to the next highest 1K increment. 


2.5.2 CATALOG Command 


The CATALOG or CAT command causes a listing of the current user's disk file directory 


to be printed on the requesting user terminal. 


For example: 


CAT 

LOGIN . BAC 15 23-MAR-?= 21-MAR-?2 GAcdd FM 
LOGOUT. BRC 15 = f4-MARR-P% GS:44 Fr 
SYSTAT. BAC <9 im Fra 
TTYSET. BAC 13 Ftd 
FIF . BAC 22 Prd 
EDIT . BARC 15 


= PM 


| f eft 


name extension size in 256- protection last access date creation date creation time 


word blocks code 
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To obtain a catalog of files stored under another user's account number, the command is 
, 


given as: 
CATALOG [190,191] 
which lists the system disk files owned by user account [ 106, 191 ]. 
CATALOG$ 
lists all files in the system library ($ indicates account [1,2 ], the system library). 
To obtain a catalog of files on a device other than the system disk, give the command: 
CATALOG dev: 


where dev: is a device specification (a user account specification can be included in such a 


command). For example: 
CATALOG DTI: 

lists all files on DECtape unit 1 (no account numbers are associated with DECtape files). 
CATALOG MT1: [20,226 ] 


lists all files stored under account [26,228] on magtape unit 1. 


2.6 USING RSTS-11 INPUT/OUTPUT DEVICES 
2.6.1 Disable Terminal Echo, TAPE Command 


The TAPE command is used to disable the terminal echo feature when reading a paper tape 


with the low-speed (terminal) reader. The command is given as follows: 
TAPE 


followed by the RETURN key. The tape is then inserted in the low-speed reader and the reader 


control switch is set to START. 
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Prior to giving the TAPE command, the user must set up conditions such that the system 


expects the tape input. For example, giving the following commands: 


NEW PROG 
TAPE 


Causes the system to await a source program file to be entered to the system via the terminal 
tape reader. The terminal echo feature is disabled, so the program is not listed on the terminal 


as it is read. This allows input to proceed more quickly than typing: 


NEW PROG 


and then reading the tape through the low-speed reader. A program listing can be obtained on 
a line printer or on the terminal at a later time, if necessary. 

In TAPE mode, RUBOUT key characters are ignored. RETURN and LINE FEED key characters 
are transmitted as is, but the LINE FEED or RETURN key characters are not appended since the 


next character on the input tape is the proper second character. 


2.6.2 Enable Terminal Echo, KEY Command 


Since no characters input from the terminal keyboard or reader are echoed following the 
TAPE command, the KEY command is supplied to again enable the terminal echo feature. The 
user is advised to type the LINE FEED key before issuing the KEY command in case the last line 


input was not terminated with a carriage return/line feed pair. The command is typed as: 


KEY 


and entered to the system with the LINE FEED or ESCAPE key.! (Carriage return characters are 
not treated as delimiters when the terminal is in tape mode.) Following successful entry of the 


KEY command, characters are again echo-printed at the user terminal. 


TESCAPE is shown as ALT MODE on some terminals. 
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2.6.3 Seize Device, ASSIGN Command 


The ASSIGN command is used to reserve an I/O device for the use of a single programmer 


(job number). The command is given in the form: 
ASSIGN dev: 


where dev: is the device specification (see Table 2-2). If the device is present on the system 


and available for use, the system returns the message: 
READY 

If the device is not available for use, the message 
DEVICE NOT AVAILABLE 

is returned, For example: 


ASSIGN LP: 

READY 

ASSIGN PR: 

DEVICE NOT AVAILABLE 


If more than one job is logged into the system under a single account number, only the user 


(job number) performing an ASSIGN (or DEASSIGN) is affected by that command. 


Table 2-2 


Device Specifications 


PR: high-speed paper tape reader 


PP: high-speed paper tape punch 


CR: card reader 

MTQ: to MT7: magtape units % to 7 

MM: to MM7: TM@2/TU16 magtape units % to 7 
LP: to LP7: line printer units @ to 7 

DT@: to DT7: DECtape units @ to 7 


KB: current user terminal 
KBn: terminal n in the system 


DX@: to DX7: floppy disk units @ to 7 

NOTE 
The user can reference LPn:, DTn:, DXn:, KBn:, MMn: and 
MTn: where n is between @ and the maximum number of such 


units on the system. LP:, DT:, DX:, MM: and MT: are each 
the same as specifying unit @ of the related device. 
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2.6.4 Release Device, DEASSIGN Command 


The DEASSIGN command is used to release the specified device to the device pool within 
the system (for use by other jobs). If no device is specified, all assigned devices are released 


from that user (job number). For example: 
DEASSIGN LP: 

releases the line printer. 
DEASSIGN 


releases all devices previously assigned by that user (under the current job number), If a 
DEASSIGN command is not given before the user leaves the system, an automatic DEASSIGN 


is performed when the user gives the BYE command. 


2.6.5 Transfer Device, REASSIGN Command! 
The REASSIGN command transfers control of a device to another job. For example, if 


DECtape unit 1 is under control of the current job, the following command 
REASSIGN DT1:8 


transfers control of the device to job number 8, This command prevents another job from seizing 
control of the device, An attempt to transfer control of a device to a non-existent job causes 


the system to generate the ILLEGAL NUMBER (ERR=52) Sone 


2.7 LOGICAL NAMES FOR DEVICES AND ACCOUNTS! 


It is often convenient to write programs which reference physical devices by logical names 
and thus make access to files independent of the physical device on which they reside. The 
user can subsequently make the necessary associations between logical names and physical 
devices before the programs are run. To associate a logical name with an assignable 


physical device, the user types the following form of the ASSIGN command: 


ASSIGN dev:logical name 


The features described in this section are not available prior to Version 5 (RSTS/E) systems. 


er systems prior to V6A, the WHAT error message is printed. 
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where dev: is the specification of the physical device and logical name is a maximum of six 
alphanumeric characters, The user can make a maximum of four such assignments for the 
duration of a job. If the user attempts to make more than four logical assignments, the system 
prints the ACCOUNT OR DEVICE IN USE error message. The association is unique to the 

job and is preserved during CHAIN operations. The command does not reserve the device 


but merely associates the logical and physical names. 


If the user makes two logical name assignments for the same device, the system recognizes 


both logical names as belonging to that device. For example: 


ASSIGN DT1L:A 
READY 
ASSIGN DT1:B 
READY 


As a result, the system associates both logical names A: and B: with DECtape unit 1. 


If the user associates two different devices with the same logical name, the system 


replaces the former logical assignment with the latter assignment, For example: 


ASSIGN DTI:A 
READY 
ASSIGN DT2:A 
READY 


After execution of the above commands, the system associates logical name A: with DECtape 


unit 2. 


If the user associates a device with a valid physical device name, the system recognizes 


the logical assignment and not the physical assignment. For example: 


ASSIGN DT@:DT4 
READY 


The system subsequently associates the physical device designator DT4: with DECtape unit 8. 


2-29 


To reserve a device for which a logical association exists, the user can type the ASSIGN 


command with the logical name and a colon as follows. 
ASSIGN logical name: 


The system reserves the associated physical device if available. The colon is required. For 
example, the following commands reserve DECtape unit 1 and associate a logical name to 


the device. 


ASSIGN DT1: 
READY 
ASSIGN DTI :ABC 


As a result, a statement of the form OPEN "ABC:FILE.EXT" AS FILE 1 in a BASIC-PLUS 
program subsequently executed attempts to open FILE.EXT on DECtape unit 1. Also, the sub- 
sequent use of ABC: in any system command refers to DECtape unit 1. An attempt to refer to a 


device using an unassigned logical name generates the NOT A VALID DEVICE error (ERR=6). 


To cancel the association between a logical name and a physical device, the DEASSIGN 


command is used as follows. 


DEASSIGN logical name 


The command does not release control of the physical device. The system automatically 


cancels associations between logical names and physical devices when the job is logged out. 


To release control of the physical device if a logical name is still in effect, the user 


can type the following form of the DEASSIGN command, 
DEASSIGN logical name: 


The colon is required. The command releases control of the physical device associated with 
the alphanumeric characters given for logical name. This form of the command does not 


cancel the association of the logical name with the physical device. 


2.7.1 Logical Assignment of a User Account 


The ASSIGN command can establish the association between a user account and the 


commercial at sign (@) character. For example, the command 
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ASSIGN [182,188] 


Associates the @ character with the account specified by the project-programmer number (100, 190]. 
As a result, subsequent system commands and program statements having the @ character apply to 
account 19,19. An attempt to refer to an account using the @ character with no assignment 
generages the ILLEGAL FILE NAME error (ERR=2). The command CAT@ prints a directory of 
account 199, 180; the command RUN @ DEMO runs the program DEMO from account 190, 180. 

In addition, BASIC~PLUS statements such as the following: 


OPEN "[10@, 10@]FILE.EXT" AS FILE 1 
can be shortened in the following manner: 


OPEN "@FILE.EXT" AS FILE 1 


To cancel the association between the @ character and the account, the DEASSIGN 


command is used. For example, either the command 
DEASSIGN [12@, 188] 
or the command 
DEASSIGN @ 
cancels the association between the character @ and account 18, 190. 
2.7.2 Disk Access by Pack Identification Label 


Each disk pack or DECpack cartridge on the system has written on it a pack identification 
label. The user specifies the label in the CCL command, MOUNT (see Section 4.14). This 
command logically mounts the pack or cartridge on the system. The system monitor stores 
this label as a device name for the disk pack or DECpack. Subsequently, a user can reference 
the pack by the pack identification label. For example, if the disk pack MYPACK is logically 


mounted on drive unit 1, the following command: 


CAT MYPACK: 
prints a directory of the current account on the disk pack mounted on unit 1. This allows users 


to refer to a disk pack without knowing the physical disk unit. 
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To make a logical association between a pack identification label and an alphanumeric 
string, the user can type the ASSIGN command subsequent to logically mounting the pack. 


The following sample dialogue shows the procedure. 


MOUNT DP1:MYPACK 
READY 

ASSIGN MYPACK:X 
READY 


The logical name X subsequently can be used to refer to the pack logically mounted on RP disk 
drive unit 1. The logical name X applies only to the current job, whereas the pack identification 
label is recognized on a system wide basis. The association between the logical name and 

the pack identification label remains in effect until the pack is logically dismounted, until 

the DEASSIGN command is executed, or until the job is logged off the system. Subsequent 

to the assignment of the logical name, a file FILE.EXT on the pack MYPACK logically 


mounted on RP drive unit | can be referenced in any one of the following three ways: 


by physical device name, DP1:FILE .EXT 
by pack identification label MYPACK:FILE.EXT 
or by logical device name. X:FILE EXT 


2.7.3 Changing Default Protection Code 


The user can change the default protection code which the system assigns to files created 
during time sharing. When the user logs into the system, the default protection code is <6g>. 
To change the default, type the ASSIGN command with the new value enclosed in angle brackets. 


For example, 


ASSIGN <40> 
READY 


The system sets the default protection code to <40> and assigns that value to any file subsequently 


created, 
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2.7.4 Changing the Magtape Labeling Default! 


The user can change the magtape labeling default when he reserves the magtape unit 
to the current job. The system-wide labeling default is set by the system manager and remains 
in effect during the time sharing session unless changed for an individual job. To change the 
default, type the ASSIGN command with the magtape device designator followed by either 
«DOS or .ANSI. For example, 


ASSIGN MT@:.DOS 


READY 


As a result, the system reserves unit @ to the current job and treats files on unit @ as having 
DOS labels. The DEASSIGN command automatically reverts the unit to the system labeling 


default. To change the default to ANSI labeling, type a command similar to the following. 


ASSIGN MT@: ANSI 


READY 


If the dot (.) character is omitted, the system assigns the logical name ANSI to the unit. 


"This feature is not available prior to Version 6A (RSTS/E) systems. 
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2.8 SCALED ARITHMETIC, SCALE COMMAND! 


The scaled arithmetic feature is available to overcome accumulated errors in fractional 
computations performed on systems using the four word floating point format. The feature 
enables the system to maintain decimal accuracy of fractional computations to a given number 
of places determined by a scale factor. The user can control the scale factor according to 


guidelines described in this section. 


Users on a system with the double-precision, four word floating-point format can optionally 
execute the SCALE command to control the scale factor. An attempt to use the SCALE command 
on systems with the single precision floating point format results in the system printing the 
MISSING SPECIAL FEATURE error message. Scaled arithmetic is described in Section 6.8 of the 
BASIC-PLUS Language Manual. 


To specify the scale factor to be used, type the SCALE command with a decimal integer 


between @ and 6, For example, 


SCALE 2 
READY 


The SCALE 2 command sets the current scale factor to 2. Subsequently, all programs compiled 
for that job have a scale factor of 2. If an invalid scale factor is typed with the command, 
the system prints the SYNTAX ERROR message. 


NOTE 


SCALE is solely a system command and cannot be 
executed as a BASIC-PLUS statement. Also, a 
program cannot refer to or modify the scale factor. 


Typing a value of § with the SCALE command disables the scaled arithmetic feature. For 


example, 


SCALE gf 
READY 


The SCALE & command sets the scale factor to 8. Programs compiled for that job subsequently 
treat all floating point calculations in the standard fashion, When a user logs a job onto the 


system, the initial scale factor is J. 


IThis feature is not available prior to Version 5 (RSTS/E) systems. 
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To determine the current scale value, the user types the SCALE command without a value. 


For example, 


SCALE 
6 


READY 


The system prints the current value (6) and the READY message. If the program in memory has a 


value set other than the current value, the system prints two values. For example, 


SCALE 
6,2 
READY 


The first value (6) indicates the current value for the job, and the second value (2) is the one 
set for the program currently in memory. If the scaled arithmetic option is currently disabled, 


the system prints a zero as the first value. 


When a user loads source statements into memory, whether by an OLD command, a RUN 
command to a BAS file, or by entering statements after a NEW command, the system sets the 


scale factor for the program in memory to the current scale factor. 


OLE TEST 
READY 


LISTNH 

14 At "HE PEE EY 
26 a .Leéz45 

36 PRINT USING AF, & 
465 ENG 


READY 


RUNNH 
G. ies4e6 


READY 


If he executes a RUN command for the program in memory, the system performs floating point 
calculations using the scale factor of the program currently in memory. Similarly, the system 


uses the scale factor of the program in memory when executing immediate mode statements. 


After loading source statements into memory, the user cannot change the scale factor 
for the program in memory. This action prevents the user from possibly executing floating 
point calculations for a program, parts of which the system assigned a different scale value. 
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An attempt to execute such a program or source statement causes the SCALE FACTOR 


INTERLOCK waming message. For example, 


READY 

OLG TEST 

REAGY 

SCALE & 

READY 

RUNMH 

SCALE FACTOR INTERLOCK 
@. 12246 


READY 


The program executes using the scale factor of the program in memory (4) rather than the 
current scale factor (6). To execute such a program with a changed scale value, the user can 
type a SAVE or REPLACE command followed by an OLD or RUN command for the related 


file, For example, 
REPLACE TEST 
READY 
OLG TEST 
READY 


RUMHH 
@. 12245 


The system consequently executes the program with the changed scale factor 6. 
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The following example illustrates the effect of different scale values for a sample program 


TEST .BAS 


OLG TEST 
READY 


RUMNH 
8. 12606 


OLG TEST 
REAGSY 


RUMNH 
O. Lez4o 


READY 


The system loads the source file using the current scale factor 2. When executed, the program 
generates results to two decimal places, and truncates the remaining places. If the user changes 
the current scale factor and loads the same program, the system executes the program with 


changed scale factor and truncates the remaining places. 


If the user stores the compiled file and later runs it with a different scale value in effect, 


the following occurs. 


SCALE 6 
READY 

OLG TEST 
READY 
COMPILE TEST 
READY 

SCALE 4 


READY 
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RUM TEST 
@. 12345 


READY 


SCALE 
4,6 


READY 


The system loads the program TEST and executes it with the scale value (6) set when the user 
compiled it. The system does not use the current value (4) but rather the value of the 
compiled program (6). This action occurs whether the program runs by a RUN command 


or by a CHAIN command, 


If a compiled program is currently in memory, the user cannot change its scale factor and 
run that program. Since it is impossible to alter the scale factor of a compiled program except 


by compiling the program again, the system generates the SCALE FACTOR INTERLOCK warning 


message. For example, 


SCALE 
4,6 


READY 

RUNNH 

SCALE FACTOR INTERLOCE 
@. 12245 


READY 


The program executes with the scale factor of the compiled program (6). 
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CHAPTER 3 
SPECIAL CONTROL CHARACTERS 
3.1 RETURN KEY 


Typing the RETURN key echoes as a carriage return/line feed operation on the terminal, 
as long as the terminal is not in tape mode. The RETURN key is normally used to terminate a 
line and enter that line to the system. In tape mode (following entry of the TAPE command) all 


carriage returns are ignored. 


Cw 
ho 


ESCAPE OR ALT MODE KEY 


The ESCAPE key, like the RETURN key, is used to terminate the current line and causes 
the line to be entered to the system. However, the ESCAPE key echoes on the terminal paper 
as a $ character and does not perform a carriage return/line feed. ESCAPE is used to enter the 


KEY command to the system. 


On some terminals the ESCAPE key is replaced by the ALT MODE key, which performs 


the same functions. 
3.3 LINE FEED KEY 


The LINE FEED key is generally used to continue the current logical line of input on an 
additional physical line. The LINE FEED key does not echo on the terminal paper but does per- 
form a carriage return/line feed operation when used with the RSTS-11 system. Typing the LINE 
FEED key automatically generates a physical, but not logical, carriage return/line feed sequence; 


so the LINE FEED is not used to terminate or enter lines to the system (except for the KEY command). 


LINE FEEDs produce errors in programs if included in constants (including string constants), 


verbs, or user-specified names for variables or functions. 


3.4 RUBOUT KEY 


The RUBOUT key is used as an eraser for the current line. If typed in tape mode, the 
RUBOUT key is ignored; otherwise, it causes the last character typed to be deleted. The erased 


characters are echoed on the terminal paper between backslashes. For example: 


1@ LEF X=X*X 
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could be corrected by typing the RUBOUT key 7 times (to remove the F) and typing the remain- 


der of the line correctly. The line would look as follows on the terminal paper: 
10 LEF X=X*X\X*X=X FAT X=X*#X 

and would appear to the system as: 
19 LET X=X*X 


In cases where the mistake is toward the beginning of a line, it may be easier to simply retype 
the entire line. For example: 


1@ LEF X=X*xX 
18 LET X=X*X 


Once the second line is entered to the system, the first line number 19 is deleted. 


RUBOUT can be used on any input line to the RSTS-11 system, including commands, as 
long as the line has not been entered fo the system with RETURN, LINE FEED or ESCAPE. 
3.5 CTRL/C 

Typing a CTRL/C (hold down the CTRL key and type the C key, release both) causes 
RSTS~11 to print READY and return to command mode where commands can be given or editing 
done. CTRL/C stops whatever RSTS-11 was doing at the time (execution or output) and returns 
control of the system to the user. 

Note that CTRL/C interrupts processing. For example, if CTRL/C is used after the REPLACE 
command is issued and before the READY reply is received, the file is not replaced in its entirety 
and is not closed. Since the file has not been closed, it cannot be accessed later. Similarly, 
if the OLD command is issued and a list of error messages is being printed, the CTRL/C key 
should not be used since the current program is only half compiled at that point. 


3.6 CTRL/U 


The CTRL/U combination deletes the current input line. This is useful when a long command 
has been typed and is seen to be incorrect. Rather than use the RUBOUT key repeatedly, CTRL/U 


deletes the entire line. This feature can be used when typing either commands or statements. 
CTRL/U deletes the entire current physical line. For example: 
40 PR int “RL PHRRET" CU 
LITSTNH 


REAR EY 
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In typing line 18 a mistake was made and the line deleted with CTRL/U. Notice that the line 
does not appear in the program listing following LISTNH. In typing line 28, below, the LINE 


FEED key is used to continue line 20 onto a second line. A physical line has been terminated. 
26 LET M = 
278. 42°U 
SYNTAX ERRGR AT LINE 2@ 


READY 


The logical statement at line 28, however is continued onto the following line and its 


deletion with a CTRL/U causes the statement at line 2M to be entered as: 


LISTNH 
726 LET M = 
READY 


which is syntactially incorrect. Had the last line been terminated with the RETURN key it 
would be entered to the system as: 

26 LET M = 

278.42 


REAGY 

which would be accepted as equivalent to: 
26 LET M = 278. 12 

3.7 CTRL/O 


The CTRL/O combination suppresses output to the terminal until the next time CTRL/O is 
typed. When a program produces a large amount of output (usually tabular form), the user may 
not wish to wait for the printing of the complete information. CTRL/O enables the user to 
monitor the output while not stopping it completely. Typing CTRL/O while occurring still 
allows the computer to output the data, but the terminal does not print it. This speeds up the 
output process, since terminals are normally slow devices. The second time CTRL/O is typed, 


the output is again printed at the terminal. 


CTRL/C, on the other hand, completely terminates program output. Think of CTRL/O as a 


switch, the first setting of which creates a condition and the second setting releases the condition. 


3.8 TAB CHARACTER 


The TAB character or CTRL/I combination allows the user to insert a tabular format into 
his typed material, When entering a program to the system, the TAB character allows format- 
ting such as shown in Figure 3-1. The RSTS-11 editor considers each Teletype line to contain 
eight tab stops, eight spaces apart, across the line. Typing the TAB character causes the 


printer head to move fo the next tab stop on the current line. 


If using a model ASR-33 or KSR-33 Teletype, typing the TAB character echoes the 
appropriate number of spaces to reach the next tab stop, The model 35 Teletypes have hard- 
ware tab stops. (See the description of the TTYSET system program for a means to enable or 


disable hardware tabstops.) 


my 


ry 

r 

i 

7 

mo 

Bit <2 


M 


Figure 3-1 TAB Character Example 


3.9 CTRL/Z 


The CTRL/Z combination is used to mark the end of a data file. When data is input from 
a file, the CTRL/Z character marks the end of recorded data. The message "END OF FILE ON 
DEVICE" is printed by the system when a 4Z is detected unless an ON ERROR GOTO statement 
is used to enable a BASIC-PLUS routine to handle the error (ERR = 11). 


3.10 CTRL/S! 


The CTRL/S combination is used to suspend temporarily output to an alphanumeric 
display terminal. This feature is used to examine the lines currently displayed on the screen 
before they are replaced by the output of additional lines on the screen. Output can be 
resumed at the next character by typing the CTRL/Q combination. This feature is usable only 
if the terminal has been initially defined with the STALL characteristic (see Section 4.5, 
TTYSET Program). 


'This feature is not available before Version 5 (RSTS/E) systems. 
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CHAPTER 4 
RSTS-11 SYSTEM PROGRAMS 


In addition to the core-resident BASIC Compiler, there are several disk-resident system 


programs available on RSTS-11. The list of programs includes the following: 


LOGIN 
LOGOUT 
SYSTAT 
PIP 

TTY SET 


QUOLST 
MONEY 


GRIPE 
EDIT 
BACKUP 
que! 


RUNOFF! 


BATCH! 


DIRECT! 
UMOUNT! 
FILCOM! 
INUSE! 
copy! 
cosBoL2 


allows users to enter the system. 
allows users to leave the system. 
provides system status summaries. 
moves data from one peripheral device to another. 


allows the user to specify functional characteristics of the user 
terminal. 


allows the user to determine his current disk quota and the amount 
of file space on each system device. 


allows the user to determine the amount of time charged to his 
account number. 


allows the user to log complaints or comments about the system. 
provides program and text editing compatible with DOS/BATCH-11 
transfers files to and recalls files from a reserve storage medium. 


enters a user's job in a system queue file for subsequent processing 
by a spooling program. 


generates a formatted listing from an ASCII file containing RUNOFF 
commands and user's text. See the RSTS/E RUNOFF User's Guide 
for operating information. 


executes an unattended job by processing user specified, standard, 
control language statements from a device or file queued for the 
batch device. 


quickly generates a listing of disk directory. 

mounts or dismounts a user's private disk. 

compares two files and reports differences found. 

prints INUSE at a terminal. 

performs fast copies of DECtapes, magtapes and RK cartridge disks. 


loads and runs the PDP-11 COBOL Compiler on systems with the 
auxiliary run time system RTSLIB. See the PDP-11 COBOL User's 
Guide for operating information. 


These features are not available prior to Version 5B (RSTS/E) systems. 
These features are optional and are not available prior to Version 6A (RSTS/E) systems. 
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sort! loads and runs the PDP-11 SORT11 program on systems with the 
auxiliary run time system RTSLIB. See the PDP-11 SORT 
Reference Manual for operating information. 


pip! the extended Peripheral Interchange Program which requires 
(extended) 16K words of user space. 


The functions and techniques for using each program are described in the following 


sections. 


This Chapter was designed in a modular format so that the system manager could remove 
or add sections depending upon the needs of the individual installation. (The Table of Contents 


reflects the material supplied by DEC.) 


The user can run some system programs by typing a unique system command called a Concise 
Command Language (CCL) command. Use of CCL commands requires that the concise command 
language option be included on the system at system generation time.2 If CCL is included on 


the system, up to 20 such commands are available. 


CCL commands allow a user to run a system program and to specify a single command for 
the program to execute. The user types the CCL command and the program command on one 
line and enters it to the system. The system loads the program into the user's job area and 
writes the program command to the core common area. This operation destroys the current 
contents of the user's job area and is similar to that performed by the HELLO and ATTACH com- 
mands which load and run LOGIN. The program runs, reads the command from the core common 
area, and executes it. If an error is encountered, the program prints a related message and 


terminates. 


Although CCL commands are installation dependent, DEC provides a table of CCL 


commands available on most systems. Shown below are some of the CCL commands. 


CCL Command Associated Program 
PIP PIP 
HELP PIP 
QUE QUE 
EDIT EDIT 
CREATE EDIT 


these features are optional and are not available prior to Version 6A (RSTS/E) systems. 
This feature is not available prior to Version 5 (RSTS/E) systems. 


CCL Command Associated Program 


DIR DIRECT 
SYS SYSTAT 
SET TTYSET 
MOUNT UMOUNT 
DISMOUNT UMOUNT 
cBL! COBOL 
COBOL! COBOL 
srt! SORTH 
sort! SORTI1 


These commands were not available prior to Version 6A systems. 


THIS PAGE PURPOSELY LEFT BLANK. 
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4.1 LOGIN PROGRAM 


The LOGIN system program runs from either a logged in or a logged out terminal. It 
: . _ 1 ‘ : 
activates a job at a terminal, attaches a detached job to a terminal, or runs designated 


system programs from a logged out terminal. 


4.1.1 Running LOGIN From a Logged Out Terminal 

As described in Chapter 2, the LOGIN system program runs when either HELLO, LoG?, 
LOGIN’, ATTACH“, ATT” or | is typed at a terminal connected to the RSTS-11 system. 
This section describes more fully the actions which occur when LOGIN runs at a logged out 


terminal. 


When a terminal is connected to the RSTS-11 system by a dial up connection, the 
automatic answering signal causes the system monitor to insert an | in the input buffer for 
that terminal. This action simulates an | being typed at a terminal directly connected to 
the system. The description of the resultant actions in this section applies to the cases 
of a terminal directly connected to the system and of a terminal connected by a dial up 


line. 


When a user enters typed characters to the system from a terminal directly connected to 
but not logged into the system, the monitor runs the LOGIN system program which checks 
the characters for a valid command. If only the RETURN key is typed, the system takes no 
action. A user entering either SYS or SET commands causes LOGIN to chain to line 32000 
of the SYSTAT or TTYSET system programs, respectively. The system manager can alter 


the LOGIN program to run other programs in the same manner. 


"s job becomes detached because the connection of a dial up line is broken or 
a privileged job executed the SYS system function to detach the job from the 
terminal, 


2 
These commands are not available prior to Version 5 (RSTS/E) systems. 


If the user types HELLO, LOGIN, LOG, ATTACH, ATT, or I, LOGIN prints the 


system identification line as in the following sample printout. 


HELLO 


RSTS VG6A-G1 SYSTEM #68@ JOB 12 KB1G @2-JUN-75 68:37 AM 
#126, 66 


The line contains the system name and version number, the local installation name, the 
job number activated, the keyboard number of the terminal, and the current system date and 
time. The pound sign (#) character printed by LOGIN on the following line requests the 


user fo type his account number. 


The user types the project and programmer numbers separated by either a comma or a 
slash and terminated with the RETURN key. (Typing the slash as a separator inhibits 
printing of any system notice messages.) The user can specify the project and programmer 
numbers on the same line as the HELLO, LOGIN, LOG or | commands as shown in the 


following sample dialog. 


HELIO 128. 66 
PASSWORD : 


When an account number is included in the command, LOGIN does not print the # character 
but immediately prompts the user to enter the password. LOGIN disables echo printing 


at the terminal when the password is typed. 


If either the account does not exist or the password does not match, LOGIN prints 
the INVALID ENTRY - TRY AGAIN message and the # prompting character. The user 
can try the sequence to a maximum of five times. LOGIN allows the user 30 seconds 
in which to type an entry. After the fifth invalid entry, LOGIN prints the ACCESS 
DENIED message and frees the job for other usage. 


A valid entry causes LOGIN to check for any other jobs which may be running on the 
system under the same account number. If other jobs are running and none are detached, 
LOGIN reports how many such jobs by printing a message similar to the following sample 


and prints the system notice messages. 


4 OTHER USER¢S) ARE LOGGED IN UNDER SH: S ACCOUNT 
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If any jobs are running detached under the current account, LOGIN instead reports the number 
of each such job and requests the user to type the number of the job to be attached to the terminal. 
The following sample printout shows the procedure. 


JOBCS> 1@ ARE DETACHED UNDER THIS ACCOUNT 
JOB NUMBER TO ATTACH TO? 16 
ATTACHING TO JOB 16 


READY 
To attach a job to the terminal, simply type its number in response to the query. LOGIN 
prints the ATTACHING TO message and attempts to attach the specified job to the 
current terminal, When the job is attached, the current job is freed for other usage and 


the attached job runs at the terminal. 


To continue running the current job, the user simply types the RETURN key in response 
to the query. LOGIN subsequently prints the message concerning other jobs running under 


the same account and prints the system notice messages, if any. 


TOBCSs 16 ARE DETACHED UNDER THIS ACCOUNT 
JOE NUMBER TO ATTACH TO? 
1 OTHER USERCS® ARE LOGGEC IN UNDER THIS ACCOUNT 


READY 
System notIces convey to the user information which the system manager places in the 
file NOTICE.TXT in the system library. If the file does not exist, LOGIN proceeds. 
If the user's job is running under a non-privileged account, LOGIN sets its maximum 
job size to 8K words. The LOGIN.BAS file can be modified so that LOGIN sets a 
different job maximum. The maximum size of a job running under a privileged account is 
normally set to I6K words. LOGIN prints the READY message and exits to the system 
monitor which clears the LOGIN program from memory. 


The cgmplete sequence to log a job into the system when other jobs are running 


detached is shown below. 


HELLO 1/216 
FASSWORD: 
JOBCSs 16 ARE DETACHED UNGER THIS ACCOUNT 


JOB NUMBER TO ATTACH TO? 


1_ OTHER USER¢S> ARE LOGGED IN UNDER THIS ACCOUNT 


READY 


1 ; 
On Version 4 (RSTS) systems, the maximum job size is determined by the amount of free core 
on the system, and cannot be specified by LOGIN, 
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The complete sequence to attach another job to the terminal when logging into the system is 


shown in the following sample printout. 


HELL} 


RESTS VGGA-@1 SYSTEM #85@ JOB 12 KEié @3-JUN-75 66:49 AM 
#17216 et es ee ae 
PASSWORD ; 

TOB<S? 26 14 ARE DETACHED UNDER THIS ACCOUNT 

I08 NUMBER TO ATTACH To? 1a 

ATTACHING TO JOE 16 


——— 


READY 


To attach a job to a terminal when the job number is known, the user can type the ATTACH 


or ATT command as follows: 


ATVACH 
RESTS V@6A-G@1 SYSTEM #880 JOR S Kb16 GS-JUN-#5 86:54 AM 


JOE NUMBER TO ATTACH TOY & 
JOB NOT DETACHED - ACCESS CENIED 


LOGIN runs and prints the system identification line and, on the next line, the JOB 
NUMBER TO ATTACH TO query. The user must type the number of the detached job. If the job 
is not detached or does not exist, LOGIN prints an appropriate message followed by ACCESS 
DENIED, The used must type another command to log into the system. 


If the job is detached, LOGIN prompts the user for the password of the account under which 
the detached job is running. After the user enters the password, LOGIN prints the ATTACHING 
TO JOB x message and attempts to attach the specified job to the terminal, An incorrect pass- 
word causes LOGIN to print the FAILURE TO ATTACH TO JOB x message and to terminate as 


shown in the following sample printout. 


ATTA CH 


RESTS WOE6A-84 SYSTEM #660 JOB 16 KEi6 @E-JUN-75 8852 AM 
JOE NUMBER TO ATTACH TO? 4 

FASSWORG: 

ATTACHING TO JOB 4 

FAILURE TO ATTACH TO JOE 4 


The user must try again. If the system successfully attaches the job to the terminal, the 
terminal becomes the console terminal of the job. Further terminal output is under pro- 


grammed rather than system control. 


To omit the printing of the identification and the query lines, simply type the job 
number on the same line as the ATTACH or ATT command as follows. 
ATT ? 


PASSWORC: 
ATTACHING TO JOB ? 


READY 


The READY message indicates that the attached job is at the system monitor level. 


If the user types the HELLO or the ATTACH! command at a terminal already logged 
into the system, the LOGIN system program is loaded into the user's job area and is 
started. The previous contents of the user's area are destroyed, LOGIN prints the 
system identification line with one additional item inserted, Between the job number and 
the keyboard number printed on the line, LOGIN inserts the project-programmer numbers 
of the account under which the current job is running. Typing the LOGIN, LOG, ATT 
or | command at a terminal already logged into the system causes the system monitor to 


print the WHAT? error message and the READY message. 
LOGIN determines if any other jobs are running under the same account and prints 


the message informing the user of the quantity of those jobs. The following sample dialog 


shows the procedure. 


READY 


HELL NM 


RSTS VYO6A-G1 SYSTEM #660 JOB * [Ciee, $6) KEG GE-JUN-75 G5 34 
1 OTHER USER(S? ARE LOGGED IN UNDER THIS ACCOUNT 


READY 


Cc 
The ATTACH command is not available prior to Version 5 (RSTS/E) systems. 
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If any such jobs are running detached, LOGIN instead prints the message informing 
the user of the number of each such job and, on the following line, prints the ATTACH TO 


query as follows. 


READY 


HELLA 


RSTS VG@6A-61 SYSTEM #680 JOB 42 £4,210] KB16 @3-JUN-75 6°56 AM 
JOB<S) 16 ARE DETACHED UNDER THIS ACCOUNT 

TOE NUMBER TO ATTACH TO? ee 

NG JOB BY THAT NUMBER - TRY AGAIN 

JOB NUMBER TO ATTACH TO” 


To attach one of the jobs to the terminal, the user types one of the job numbers reported 
in the message. LOGIN determines whether the job is nonexistent or whether it is 
already attached to another terminal. In either case, the program prints an appropriate 


error message saying try again and subsequently reprints the ATTACH TO query. 


To continue running the current job, type the RETURN key in response to the ATTACH 
TO query. Asa result, LOGIN prints the information message telling how many other 
jobs are running under the same account and prints the READY message. The system clears 
the LOGIN program out of memory. 
JOB NUMBER TO ATTACH TOY 
4 OTHER USER*S? ARE LOGGEG IN UNDER THIS ACCOUNT 
READY 
When the user responds to the ATTACH TO query by typing one of the job numbers 


reported in the message, the program proceeds as shown in the following sample printout. 


HELLO 


RESTS WG6AR-G1 SYSTEM #6¢@ JOR 12 (Cit,24@)] Ket6 G@E-JUN-75 G3 a1 AN 
Jub¢S? 16 ARE DETACHED UNGER THIS ACCOUNT 

JUB NUMBER TO ATTACH To? 16 

ATTACHING TO JOB 16 


READY 


The READY message indicates that the new job is at system command level. 


To attach to a job known to be running detached under the same account, the user 
can type the job number on the same line as the ATTACH command. The LOGIN program 
determines if the job specified exists and is detached. If not, it prints an appropriate 
error message and the ATTACH TO query. The user can type another job number or the 
RETURN key. If the job exists and is detached, LOGIN compares the account numbers 
under which both the current job and the detached job are running. If the accounts 
are different, the program prompts the user for the password of the account under which 


the detached job is running. The following sample printout shows the procedure. 
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ATTACH @e2 

NO JOB BY THAT NUMBER - TRY AGAIN 
JOE NUMBER TO ATTACH TO? 14 
FASSWORD: 

ATTACHING TO JOB 16 

FAILURE TO ATTACH TO JOB 16 


READY 


After the user enters the password, the program prints the ATTACHING TO message and 
attempts to attach the detached job to the terminal. If the password is not valid, the 
program prints the FAILURE TO ATTACH and the READY messages and exits to the monitor, 


which clears the LOGIN program from the user's job area, 


When the account numbers of the two jobs are the same, LOGIN omits the PASSWORD 


prompt message and attaches the job as shown below. 


ATTACH 416 
ATTACHING TO JOB 16 


READY 
The READY message indicates that the job is at the system monitor level. 


To change accounts without logging off the system, simply type the HELLO command 


followed by the account niabers! For example: 

READY 

HELLO 

RSTS V@GA-61 SYSTEM #860 JOB 1@ (126,86] KEié G@3-JUN-75 69:49 AM 


HELLO 126/84 
PASSWORD: 


READY 
HELL 


RSTS VG@6A-G@1 SYSTEM #660 JOG 1@ ([i126,81] Ke&ié G@3-JUN-75 89:45 AM 
READY 


To have the system print the system notice message, merely replace the / character in the 


account number with a comma. 


This feature is available only on Version 5 (RSTS/E) systems. 
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4.1.3 Running Other Programs from a Logged Out Terminal 


Certain commands typed at a logged out terminal cause LOGIN to chain to line 
32000 of another program in the system library. The system manager can modify the 
LOGIN program to recognize other commands and to chain to line 32000 of a program 
stored in the system library. The commands which the unmodified LOGIN recognizes 
are SYS and SET which respectively cause the SYSTAT and TTYSET system programs to 


rune 


For example, it is convenient to determine job status without logging a job into the 


system. The following printout shows the procedure. 


41 1.216 KBa? NONAME Zk KB 


LOGIN runs and recognizes the SYS command of the SYSTAT system program. LOGIN 
writes the option given in the command in the core common area and chains fo the 
SYSTAT program at line 32000, SYSTAT reads the option from the core common area and 
prints the appropriate report, after which it chains back to LOGIN. LOGIN prints 


the BYE message and exits to the system monitor which clears the contents of memory. 
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4.2 LOGOUT PROGRAM 


LOGOUT is called when the user has completed all processing and is ready to leave the 
terminal. The LOGOUT program is started when the BYE command is typed at a user terminal 
logged into the RSTS-11 system. LOGOUT checks the current user's disk quota to ensure that 
the user does not log out of the system with more than the acceptable amount of disk storage 
being used for his files. If the user's disk files are within the acceptable disk quota size, 
LOGOUT disconnects the terminal from the system, removes the current job number from the 


list of active jobs and prints some information on the duration of the current job. 
In response to the BYE command, LOGOUT prints: 
CONFIRM: 
The user can type any of the responses shown in Table 4-1, 


Table 4-1 
LOGOUT CONFIRM: Responses 


The system performs the checks described above. If 
successful, the LOGOUT messages are printed. If not 
successful, an error message is printed and the user 
must delete some files. 


These responses indicate that the user does not want to log 
out of the system. The LOGOUT procedure is terminated 
without logging the user off the system and the system 
prints the READY message. 


Causes LOGOUT fo print an explanation of the acceptable 
responses to CONFIRM: 


Causes LOGOUT to print a message instructing the user to 
type ? to obtain a description of logout procedures. 


Causes LOGOUT to enter individual file deletion mode, 
Same as RETURN key. 


Causes a fast logout procedure if user's disk storage space 
is within acceptable limits. 


In individual deletion mode, LOGOUT prints the name, size, protection code, and 


creation date of each file stored under the current user account number on the system disk. This 
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information is followed by a ? after which the system awaits a response from the user which 


Lee 


Save the file just listed. 


can be: 


File Deletion 
Mode Response 


RETURN key 
K 


Delete (kill) the file just listed. 


An example of a LOGOUT sequence is shown below: 


BYE Y 
CISK GUOGTA OF 406 EXCEECEG EY 238 BLOCKS 
f VE DELETED BEFORE LOGGING OLIT 


= cae ST BE 
TYFE “7° FOR HELP 
CONFIRM: I 


A BAS 156 é@ LS-AUG-74 2 
C EAS 1268 Go 15-AUG-F4 
B _ BAS 156 é@ 15-AUG-F4 oF OK 


TYPE “2° FoR HELP 

CONFIRM: v 

SAVEO ALL GISKE FILES; 388 BLOCKS IN USE, ihe FREE 

JOB 16 USER 126, 66 LOGGED OFF KEI AT 25-AUG-F4+ @4-96 PM 
SYSTEM RSTS V@SB-24 SYSTEM #868 

RUM TIME WAS 1.6 SECONDS 

ELAPSEG TIME WAS 2 MINUTE, 31 SECONDS 

Ghob AFTERNGUN 


LOGOUT statistics for a job which was detached at any time include accumulated run 


time and elapsed time statistics. 


The user can omit the CONFIRM: message by typing the BYE command and the response 
to the CONFIRM: message! . For example, to perform a fast logout, type the following. 


BYE F 
The LOGOUT program runs and performs the fast logout procedure by printing a series of 
LINE FEED characters instead of printing the final accounting information. If the user job 


exceeds the acceptable limit for disk storage, LOGOUT prints the QUOTA EXCEEDED 
message and the CONFIRM: message to allow the user to delete some files before logging out. 


os : . : 
This feature is not available prior to Version 5 (RSTS/E) systems. 
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4.3 SYSTAT PROGRAM 


The SYSTAT program provides current system information in the areas of job, device, 
disk, and buffer status. SYSTAT can be called by a user logged into the system or from a ter- 


minal which is on-line but not logged into the system. 
To start SYSTAT while logged into the system, type: 
RUN $SYSTAT 
If not logged into the system, type: 
SYS 


If the user is already logged in, the system responds by printing: 


OUTPUT STATUS TO? 


at which point the user can indicate any RSTS-11 device or a filename specification for the 


status report output. Possible replies by a user logged into the system are described below: 


SYSTAT Output Response Meaning 
send status report to the line printer if only one line printer is on the system 
or to line printer unit @ if multiple line printers are on the system. 


LPn: send status report to line printer unit n if that printer is not currently in use. 


KB: send status report to the user terminal. (The RETURN key is equivalent 
to responding KB:) 


KBn: send status report to user terminal n in the system if that terminal is on-line 
and not currently in use. 


PP: send status report to the high-speed paper tape punch, 


dev:filename.ext — send the status report to the file specified. The default device is the system 
device. No extension is appended unless specified by the user. 


If SYSTAT is run by a user not logged into the system, the report is always sent to the user 


terminal requesting the report. 


Following the device or filename specification, the user can specify one of the options 
in Table 4-2 to obtain a partial system status report. The option specifications are preceded 
by a slash if the user is logged into the system. The options can be typed following the SYS 


command if the user is not logged into the system. 
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Table 4-2 
SY STAT Options 


SYSTAT Option 
Specification Meaning 


Report complete system status to include job, run time system, 
busy device, disk structure and free buffer status statistics. 


report only run time system statistics! 
report status for job n only 
report only job status 


report only busy device status 


report only disk status 
report only free buffer status 

report only the status of terminal n in the system 

report only the status of detached jobs? 

report only the status of any jobs active under account [n,m] 


report only the status of jobs not logged into the system 
The options S, B, D, and F can be specified as separate options or in any combination. 
The following examples are performed on a terminal logged into the system: 


RUN $SYSTAT 
OUTPUT STATUS TO? STAT creates complete system status report in the file STAT under 
the current occount in the public structure. 


RUN$ SYSTAT 
OUTPUT STATUS TO? LP: /3 causes output of a status report for job 3 to the line printer. 


RUN$ SYSTAT 


OUTPUT STATUS TO? /D causes output of disk status report to the user terminal. 

RUN$ SYSTAT 

OUTPUT STATUS TO? /SF causes output of job and free buffer status to the user 
terminal. 


IThis feature is not available before Version V6A systems. 


Normally, a job is detached only by use of a certain system function or because of a dataphone 
disconnect affecting a remote user. 
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The following examples are performed on a terminal not logged into the system: 


SYS causes output of complete system status report to the terminal. 

SYS /D causes output of the disk status report to the terminal. 

SYS /BF causes output of the busy device and free buffer status reports to the 
terminal, 

SYS /5 causes output of a status report for job 5 to the terminal. 

SYS A/B causes the FATAL SYSTEM I/O FAILURE error since SYSTAT 


cannot create a file for a logged out job. 
A complete system status report is shown below:! 


RUM €S54'STAT 
QUTFUT STATUS To 


RESTS V@GA-G1 SYSTEM #958 STATUS ON @2-JUN-F?5 AT @4:45 FM UP: 25-49-34 


JOE WHC WHERE WHAT SIZE STATE RUN-TIME 
1 COrFR J CET ERRCEY 4k SL Sid zr.@ 
z CORR CET GQUEMAN LEE SL F:O1.2 
= CORR] CET SPOOL Lak SL SW 13:34. 4 
4 [GFR] CET SP 18k SL SW a. A 
ba CORR 3 DET BATCH 15k SL SW 1:32.7 
6 COPR I CET BATCH 45K SL SW Se. = 
? 2, 106 CET VTSORY idk SL 5 25:47. 5 
5 ec, 6& KBa4 NHONAME 2k KE Sid 1:25.25 
g 4, 266 EBEa TECG 14k KE Si 9:54.7 
1a C SELF I EBLE SYSTAT eK Rt S45 
ii 255,46 RES TECO EK EB SW =S. 
12 i146,2 KBE NONANE 2K EE Sid EE. 4 

= COPE J KBi4 GUE Lik EE SW 4.6 
14 COPR J EBL MAC LSk KE 1:33. 4 
16 258, 84 EELS SORTAL SE KB SW B:7a 4 
i? é@46,4 EEL? TECOG SK EB Std 46.5 

RUN-TIME SYSTEMS: 

NAME SIZE USERS COMMENTS 

BREIC LSE 18 FREAD ONLY 

RTSUIE 4k 1 READ ONLY: TEMPORARY 

BUSY DEVICES: 

GCEVICE JOB WHY 

EBLE - INIT 

LPa = AS 


lOn Version 4A-12 (RSTS) systems, SYSTAT prints a count of the catastrophic errors in the 
buffer status information, On RSTS/E systems before Version 6A systems, SYSTAT does not 
print run time system or priority information. 


4-17 


OISE STRUCTURE: 


OLSk OREM FREE CLUSTER ERRORS COMMENTS 
CBE ? 22645 4 2a PUBLIC 
CEL 14 SBHZE 4 a PUBLIC 
SMALL LARGE HUNG TTY’S 

466 i a 

READY 


The job status information includes a list of all active jobs by job number, the account 
number under which each job runs, the keyboard involved, the program name and size, the 
job state, the total amount of central processor run time exhausted, and the job priority. In 
the WHO column, SYSTAT substitutes OPR for the project-programmer number to denote an 
operator account. An operator job has a project number of 1 and a programmer number 
between | and 200. In the WHERE column, DET appears in place of the keyboard number for 
job which run detached from a keyboard. The SIZE column shows two numbers separated by a 
slant character. The first number is the current size in words; the second number is the size to 
which the job can expand. The STATE column contains an abbreviation (see Table 4-3) telling 
the condition the job is currently in. The RUN-TIME column gives hours, minutes, seconds, 
and tenths of seconds of central processor time the job has consumed. The PRIORITY column 
(printed only if job is privileged), gives the number which the system assigns to determine 
the order in which to run jobs. Most jobs run at -8 priority; system jobs run at special 


priorities of @ or higher. 


The run time system information gives the name of each module, its size in words, the 


number of user jobs currently executing under its control, and comments regarding its status. 


The device status information reports devices which are busy, having been assigned or 
opened by a specific user. Items reported are the device specification, the job owning that 


device, and the condition of the device. 


The disk status information describes each disk (public and private) currently mounted. 
Items reported are: disk name (device specification), number of open files, number of free 
512-byte blocks, pack cluster size, disk hardware error count, and the public/private and 


locked/unlocked status of the device. 


The buffer status provides information on the number of small (16-word) and large (256- 
word) buffers currently not in use, and a count of the number of times a hung terminal was found. 
A hung terminal is one which fails to respond to character transmission within a given time period. 


The system attempts to unhang the terminal and increments the hung terminal count. 
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The abbreviations used in the SYSTAT report are defined in Table 4-3. 


Table 4-3 
SYSTAT Abbreviations 


job is detached from all terminals 
job is not logged into the system but is running LOGIN, SYSTAT, 
or TTYSET 

job is swapped out (not currently in core) 

job is running or waiting to run 

job is waiting for residency 

job is detached (waiting to be attached to a terminal) 

job is waiting for file processing action by the system 

job is sleeping (SLEEP statement) 

job is waiting for card reader input 

job is waiting for magtape I/O 

job is waiting to perform line printer output 

job is waiting for DECtape I/O 

job is waiting to perform output on the high-speed paper tape punch 
job is waiting for input from the high-speed paper tape reader 

job is waiting to perform output fo a terminal 

job is waiting for input from a terminal 

job is waiting to perform disk I/O 

device is explicitly assigned to a job 

device is open on a channel 

job runs under a system operator account 

magtape is assigned with DOS/BATCH labeling format 

magtape is assigned with ANSI standard labeling format 

job is waiting for pseudo keyboard I/O 
job is waiting for floppy disk I/O 

job runs under the current user account 


4.3.1 SYS as a CCL Command 


SYS as a CCL command works similarly to SYS typed at a logged out terminal. The CCL 
command, however, can contain a file specification. The following commands show the 


proper procedure. 


SYS B 


READY 


SY STAT creates file B and writes to it a complete system status report. The file resides under 


the current user account in the public structure. 


SYS /B 


SYSTAT prints a busy device status report at the terminal. To create a status report in a file, 


type the file specification with an option as follows. 


SYS B/B 


READY 


SYSTAT creates a busy device status report in file B. 
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4.4 PIP PROGRAM 


The PIP (Peripheral Interchange Program) system program performs disk and peripheral device 
transfers as well as several other file utility functions. Two forms of the PIP program are avail- 
able;! the only difference being that one runs in less than 8K words of memory and is generally 
less powerful than the larger version which requires 16 words to run. Refer to Section 4.18 for 
a description of the larger version of PIP. (RSTS-11 PIP commands, wherever possible, have 


been made compatible with DOS/BATCH-11 PIP commands.) 
PIP can be called by users logged into the system as follows: 
RUN $PIF 
PIP responds by identifying itself and printing a pound sign (#) to indicate that it is able to 
accept input commands: 


PIF - RSTS VOSE-e4 SISTEM #588 
# 


In order to return to the RSTS-11 Monitor, type CTRL/C or CTRL/Z. The system responds 
by printing READY. For example: 


ins 


READY 


A CTRL/Z is equivalent to an End-of-File on the user terminal and causes an orderly exit from 
PIP. Typing CTRL/C causes an immediate exit from PIP and possibly leaves the user's files or 


directory in a disorderly state, 
4.4.1 PIP Command Line Specifications 


Spaces and tabs within a PIP command line are ignored. PIP commands must be typed on 


a single line and be no more than 8@ characters long. 
Output file specifications are of the form: 
dev: [proj,prog] name.ext <prot> 


The elements of the output file specification are described in Table 4-4, Input file specifica- 


tions are of the form: 
dev: [proj,prog] name.ext 


Elements of the input file specification are described in Table 4-5, 


lon systems prior to Version 5C (RSTS/E), two different forms of PIP were distributed: a Record 
I/O form and a non-Record I/O form, The non-Record I/O PIP performed only formatted 
ASCII transfers. 


20n Version 4A-12 (RSTS) systems, PIP prints the asterisk (*) character instead of the pound sign. 


4-21 


Table 4-4 


Output File Specification Elements 


Element Description Default 
dev: device specification system disk (DF:,DK:, or DP:) 
[proj,prog] account specification, project- 

programmer number current user account number 
name filename specification! none 

; . 1 

ext filename extension none 
<prot > protection code < 60 >, equivalent to read and write protect 


against everyone but the owner 


no specification KB: 


TOutput-only devices (non-file-structured devices) such as KB:, LP: and PP: ignore the file- 
name and extension specifications. 


Table 4-5 


Input File Specification Elements 
Element Description Default 


dev: device specification system disk (DF:,DK:, or DP:) 
[proj,prog] account specification, project- current user account number 
programmer number 


] 


name filename specification none 
.ext filename extension! «BAS (BASIC=-PLUS source program) 


no specification last file specification is used again, 
Initial default is DF: 


Mnput-only devices (non-file-structured devices) such as KB:, PR: and CR: ignore 
the filename and extension specifications. 


With PIP there is at most one output file, but there may be any number of input files. 
Where more than one input file is specified, all filenames which are not preceded by a device 
specification are assumed to be on the system disk. A null file specification duplicates the 


immediately preceding file specification in all details. 
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PIP options are specified in the form: 
/option:argument 


Options are always begun with a slash and terminated with a comma (,), left angle bracket 
(<), another slash (/), or a line terminating character (RETURN or ESCAPE). The option 
argument is a function of the individual operation to be performed. The default option 


is a formatted ASCII file transfer. 


4.4.2 File Transfers Including Merge Operations 


. f rT . . A ° * 
File transfer and/or file merge operations take the following command format: 
#output file<input file(s) /option 


Only one output file can be specified. If one input file is specified, a copy of 
that file is transferred to the output file specification (the original input file remains 
untouched). If more than one input file is specified, copies of the file are merged into 
a single output file (the original input files remaining untouched). The options available 


on a file transfer and/or merge operation are described in Table 4-6. 


As an example: 


FIF - RSTS VOSb-2d SYSTEM #856 
#071: FILET. BAS<FILE1, FILES, PR: OTe: AA. BAS 


The above command string takes the files FILE] and FILE2 from the system disk, a single 
file from the high-speed paper tape reader and file AA.BAS from the tape reel mounted on 
DECtape unit and creates the single file FILET BAS on the tape reel mounted on 
DECtape unit 1, 


Since a PIP command must be typed on a single line, the number of files which can 


be merged into a single file is limited only by a command string length of 88 characters. 
4.4.3 Change Filename or Protection Code 


PIP can be used to change a filename specification without transferring any data. 


The general format for such a command is as follows: 
#new file specification = old file specification/RE 


To change the filename, extension and/or protection code of a stored file, type the new file 


specification (including the device specification and, optionally the protection code), followed 
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Table 4-6 
File Transfer and Merge Options 


Function 
no option ASCII file transfer is performed, 


/FA Formatted ASCII transfer is performed (Nulls, parity bits! ; 
and RUBOUT's are ignored). 


/BL Block mode transfer is performed using the default block 
sizes. 


/BLi:n Block mode transfer is performed using a block which is n 
bytes long. 


/CO Contiguous mode transfer is performed with null fiJl char- 
acters inserted into any partial buffer remaining. Must 
be used when transferring a .BAC file, a virtual core array, 
or a file created by Record I/O, from disk to DECtape. 


Contiguous mode transfer is performed with any partial 
buffer remaining being truncated.“ Must be used when 
transferring a .BAC file, a virtual core array, or a file 
created by RECORD I/O from DECtape to disk. 


Set cluster size ton. 


Ignore "USER DATA ERROR ON DEVICE! errors. 


Appends '$PIP.TXT' to command line to have PIP output 
the helping text explaining PIP commands and options. 


Update file transfer (equivalent to OPEN AS FILE used 
for output files). 

Disable rewinding of magtape before and 

after a file transfer, 


IParity bits are associated with some ASCII codes, making each ASCII character 
8 bits long rather than 7 bits. The DOS/BATCH Monitor system uses even parity 
ASCII. Even parity implies that the number of bits set within the 8 bit field is 
an even number. 


2Available only with the Record I/O version PIP program. 


by an equal sign (=), followed by the current file specifications followed by /RE, The current 


protection code need not be indicated. For example: 


#FILE EXT <4 > =ABC,DAT/RE 
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In this example, the filename, extension, and protection code are changed. 
#DT1:MAT .BAC=DT1:ORIG.BAC/RE 


In this example only the filename is changed. The protection code for the file MAT.BAC remains 


the same as it was for ORIG BAC, 


In the case where only the protection code is to be changed, a new filename specification 


need not be typed. A shorter form is: 
fold file specification<prot> /RE 
This command string format indicates that the file protection is to be updated. For example: 


#=MAG ,BAS <48>/RE 


Notice that the device specification on both sides of the equal sign must be the same. If it is 
desired to move the file from one device to another, the file merge technique (see section 
4.4.2) is used. Note also that PIP assumes a default filename extension of .BAS on input files, 


but an extension must be specified on output files or none is appended. 
4.4.4 File Deletions 


To remove a file from the system, type the file specification followed by the /DE (delete) 


option, For example: 
#TRY2,BAC/DE 


This command string causes the file TRY2.BAC to be removed from the system disk if found under 
the current user's account number. No default assumptions are made as to the filename exten- 


sion. An extension must be specified if the file was stored with an extension. 


The user cannot delete a file under another account or a file which is write-protected 
against him. If an attempt is made to delete a non-existent file from a device, the error mes- 


sage CAN'T FIND FILE OR ACCOUNT is given. 
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More than one file can be deleted by specifying several file specifications, separated 


by commas. For example: 
*FILET.BAC, FILE2. BAC, DT 1:FILE1. BAC/DE 


deletes FILE].BAC from both the system disk and DECtape unit 1 and deletes FILE2.BAC from 
the system disk. The number of files which can be deleted in one PIP command string is limited 


only by the maximum length of the command line. 
4.4.5 Zero Device Directory 


Zeroing a device directory removes all files stored under one account number on the 
given device. In order to perform this operation, log in to the system under that account num- 
ber (with the correct password) and run PIP, giving the device specification followed by the 
/ZE (zero) option: 


#/ZE 
REALLY ZERO [120,80] SY:? 


If the user does not type a device specification, PIP assumes the system disk and prints the 
REALLY ZERO account question, To cancel the operation, type the RETURN key. To remove 
all files from the current account on the system disk, type Y or any string beginning with Y. 
Note that only the current account can be zeroed, The user must not specify an account number. 


The following example shows the command te zero a DECtape. 


#DT1:/ZE 
REALLY ZERO DT1:? 


PIP prints the REALLY ZERO device question since no separation of files by account exists for 


DECtape. Hence, any user can remove all files from a DECtape reel by the zero action, 


If the user is concerned with fast access to files stored under his account, he can restructure 
his account periodically by use of the /ZE option, The RSTS-11 file allocation mechanism appor- 
tions storage space for files on the disk on an as-needed basis, After a user performs numerous 
file deletion, creation, and extension operations, the internal linkages in his account on a disk 
point forward and backward in an unordered fashion, To regain an optimum, ordered structure 
for fast access to files under his account, the user first transfers those files he wishes retained 
to an external medium. He then uses the /ZE option to remove all files stored under his account 
from the disk, He then transfers the files to be accessed back to his account. As a result of 
these actions, the newly assigned linkages (storage and accessing structures) are ordered in an 
optimum manner for fast access. 
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4.4.6 List Device Directory 


The user can request a listing of all files under his account number, all files with a given 
name or extension under his account number, or a particular file under his account number on 
the system disk or any one or more devices. The format of the directory listing command is as 


follows: 


output <input file(s) /option 


An output file specification can be supplied where an output device other than the user terminal 


is desired. The more usual form of the command is: 


#input file(s) / option 


in which case the directory listing is sent to the terminal issuing the command. Unless another 


device is specified, only a directory of the system disk is printed. For example: 


RUN $PIF 
FIF - RSTS VOSB-24 SYSTEM #esa 


#078, OTL. 1 


causes a full directory listing of files for the current user on the system disk (the blank 
device specification, indicated by the comma with no preceding characters indicates the 


system disk), and on DECtape units and 1. 


The options available with device listings are described in Table 4-7. The input file 


specifications are described in Table 4-8. 
Table 4-7 


PIP Directory Listing Options 


BRief directory listing is printed; includes only filenames and 
extensions with four file specifications on each printed line. 


Normal Directory listing is printed; includes filename’, exten- 


sion, length, protection code, and creation date. 


Full (Slow) directory listing is printed; includes: 

a. for disk devices: filename, extension, length, protection 
code, creation date and time, 

b. for magtape or DECtape: filename, extension, length, 
protection code, creation date. 
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Table 4-8 


Input File Specifications 


Directory Printed Includes 


all files on the system disk under the current user account 
number . 


Input File 


dev: 


all files under the current user account number on the 
device specified . 


dev:* ,* same as the above, 


dev:filename,* 


all files having the filename specified, under the current 
user account number, on the device specified. 


dev:name.ext 


only the file specified, under the current user account 
number, on the device specified. 


Where no device is specified, the default device is the system disk; no message is 
printed if the particular input file specification(s) cannot be found; where several 
input file specifications are given, they are separated by commas. Account num- 
bers are only significant for disk files and magtape files. 


4.4.7 Guidelines for Transfer Operations and DECtape Usage 


The PIP system program performs transfer operations in any one of several ways depending 


upon options the user specifies. The options are listed in Table 4-6. 


If the user specifies no option in a transfer request, the system checks each byte of data 
for a CTRL/Z combination CHR$(26). (In Version 4 (RSTS) systems, the CTRL/Z character is 
defined as the ASCII file terminating character. For compatibility with Version 5 (RSTS/E) 
systems, it indicates the end of data in the last block of an ASCII file.) PIP transfers the 
data block by block. The last block transferred by PIP is either the last block in the file or 
the block containing a CTRL/Z combination. 


The ASCII type of transfer is convenient for moving BASIC-PLUS source files from one 


device to another. For example, 


#DT1:FILNAM.BAS< FILNAM.BAS 
# 


PIP transfers the source code from the system disk to DECtape and terminates the transfer when 
the last block in the file is encountered. Any extraneous data following the END statement 
in the last block of the file causes no harm since the Run Time System recognizes the END 


statement as the end of file. 
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Under certain circumstances, PIP can be forced to discard unwanted NUL and RUBOUT 
characters. The user can specify the /FA option in the transfer request when he creates an 


ASCII text file from the keyboard or prints an ASCII text file at the keyboard. For example, 


#KB:< FILNAM. TXT/FA 


(PIP prints the text.) 
# 


PIP terminates the transfer of the disk file upon encountering the CTRL/Z character. Any NUL 


or non-printing characters are discarded. 


The ASCII transfer is not suitable for files containing 8-bit binary data. The bytes ina 
virtual core array or record I/O file can take any pattern of 8 bits, one of which can be that 
of the CTRL/Z character. If the user transfers such a binary file with the ASCII type of transfer 
request, the unpredictable occurrence of the CTRL/Z character pattern causes PIP to terminate 
the transfer and possibly loses data. To transfer such binary files between like devices, use 


the /BL option. For example, 


4DTI:FILNAM.DAT<DT@:FILNAM -DAT/BL 
SD KO:FILNAM eDAT< DK1:FILNAM.DAT/BL 


PIP transfers the data between the devices strictly block by block and does not check any 


characters. The default block size of the device is used. 


Since both magtape and disk have the same default block size (512 bytes), the user can 


also specify the /BL option in transfers between magtape and disk. For example, 


EMT9:FILNAM eDAT < DK1:FILNAM.DAT/BL 


PIP terminates the transfer when the system signals the end of file on the disk. The file on 


magtape contains 512 bytes per block. 


Because the block sizes of DECtape (510 bytes) and disk (512 bytes) are different, PIP 
cannot properly handle block by block transfers of binary files between these two devices. If 
a DECtape block is transferred to disk, two extra bytes are generated on the disk; if a disk 
block is transferred to DECtape, two bytes are lost. Thus, to transfer binary files from disk to 


DECtape, the user must specify a special option - the /CO option. For example, 


4D19:FILNAM -DAT< DK@:FILNAM. DAT/CO 
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As a result of the user specifying the /CO option, PIP transfers the file as a stream of contiguous 
bytes in 510 byte portions. In the last block on DECtape, the system fills any unused locations 
with NUL characters. In this manner PIP preserves the two extra bytes in the disk block. To 
transfer a binary file on DECtape to the disk, the user must specify the /CO:T option. For 


example, 


- ILNAM.DATXDT@:FILNAM.DAT/CO:T 


As a result of the user specifying the /CO:T option PIP transfers the file as a stream of 
contiguous bytes in 512 byte portions and truncates null characters in the last buffer. This 
action prevents the length of the file on disk from increasing when no new data is added. 

(A 10 block file on disk, for example, requires 10 blocks plus 20 bytes - a total of 11 blocks - 
on DECtape.) 


Transferring a compiled file requires a special type of transfer. A compiled file is a 
unique form of a binary file. (Note that PIP allows only privileged users to transfer compiled 
files.) When transferring a compiled file, the user must specify one of the options described 
above and required for binary files. Moreover, if the output device is disk, the user can 
specify the /CL:4 option. This procedure forces PIP to create the output file in clusters of 
four contiguous blocks and is helpful since compiled files are always in 1K word clusters on 


the disk. 


The user can transfer a file from a device whose block size is other than 512 bytes by 
specifying the /BL:n option. For example, to recall a file on magtape created by the 


BACKUP program with a block size of 2048 bytes, type a command similar to the following. 


#FILNAM -DATSMT1:FILNAM.DAT/BL:2048 
# 


PIP reads 2048 byte blocks from the magtape file and creates a disk file using a RECORD 
SIZE value of 2048. 
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The /BL:n option can also optimize transfers of large files from disk to disk or from disk to 
magtape. The advantage is gained by specifying a block size larger than 512. For example, 


if a large data file resides on a disk, the user can specify the /BL:2@48 option in the transfer 
request. PIP subsequently reads four blocks at a time from the input file rather than executing 


four separate read operations and writes the output file using a RECORD SIZE value of 2048. 


4.4.8 PIP asa CCL Coniniand: 


The standard CCL table supplied in the RSTS/E generation kit includes PIP as a CCL 
command. If PIP is included in the CCL for the system, the user may invoke the PIP program 


simply by typing: 
PIP 
This results in exactly the same response as; 
RUN $PIP 
Also, typing 
PIP <string> 


causes PIP to run, process <string> as a standard PIP command, and retum to the READY state. 
For example, if the following is typed in response to monitor's READY message: 


PIP LP: <FILE 


a copy of FILE is printed on LP@:. Note that whatever was previously in core before the PIP 


command was executed is now destroyed. 


Ta, 3 . : 
This feature is not available prior to Version 5B (RSTS/E) systems. 
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4.5 TTYSET PROGRAM 


The TTYSET system program is used to establish terminal characteristics for the user ter- 
minal. TTYSET can be run by any user before or after he is logged into the system. If the 
terminal is not logged into the system, only one command can be entered to the TTYSET 


program at a time in the following format: 
SET xxxx 


where xxxx represents one of the TTYSET commands shown in Table 4-9 and is entered with 
the RETURN or ESCAPE key. If the user is logged into the system, he can run TTYSET as 


follows: 


RUN #TTYSET 

“TIVSET” TERMINAL CHARACTERISTICS PROGRFIM 

2 NERR 7 
where xxxx is again one of the TTYSET commands shown in either Table 4-9A or 4-9B. When 
xxxx has been entered to the system with the RETURN or ESCAPE key, TTYSET again prints ? 
to accept additional commands. To return control to the RSTS-11 Monitor, type EXIT, CTRL/C, 


or CTRL/Z. 
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Table 4-9A 
RSTS/E TTYSET Commands 


Standard 
Function Condition 


Set the width of the print line for this See Note 1 
terminal to n which can be between 1 

and 254, Asa result, the system auto- 

matically generates a CR and LF sequence 

if n printing characters have been printed 

and another printing character is to be 

transmitted. 


Enable hardware tab control. System 
transmits HT characters without 
translation. 


Disable hardware tab control. To move 
to the next tab stop, the system trans- 
mits the correct number of space 
characters instead of transmitting an 
HT character. 


Enable hardware form feed and vertical 
tab control. System transmits FF and 
VT characters without translation. 


NO FORM Disable hardware form feed and vertical 
tab control. System transmits 4 line feed 
characters in place of a FF or VT 
character. 


LC OUTPUT System transmits the lower case 
characters CHR$(96) through 
CHR$(123) inclusive to the 
terminal without modification. 


NO LC OUTPUT System translates any lower case 
character to its upper case 
equivalent before transmitting it 
to the terminal. 


leae Table 4-10 for the individual characteristics set by RSTS/E. 
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Table 4-9A (Cont.) 
RSTS/E TTYSET Commands 


Special terminal hardware allows the 
computer to interrupt transmission of 
characters from the terminal by sending 
the terminal an XOFF character 
CHR$(19). Similarly, the computer 
instructs the terminal to resume trans- 
mission of characters by sending the 
terminal an XON character CHR$(17). 
The terminal hardware must respond to 
XOFF and XON characters by ceasing 
and resuming transmission, respectively. 


Standard 
Condition 


See Note ] 


XON 


NO XON Terminal does not have hardware required 
for XON feature. 


LOCAL ECHO Terminal, or its acoustic coupler, echo 
prints characters as they are generated 
locally. System does not echo characters 
received from such a terminal. 


FULL DUPLEX Characters generated are sent only to the 
computer. System therefore echoes each 
character received so that it will be 
printed locally and translates certain 
characters to perform the proper action. 
For example, a CR character received is 
echoed as a CR and LF character sequence. 


Terminal uses a CRT display and the 
following characteristics: 


a. Conforms to synchronization 
standard (can be conditioned 
by the STALL command), 


System echoes a DEL character 
(RUBOUT) as backspace, space, 
and backspace sequence. 


Terminal generates NUL characters 
as fill for timing the following 

operations: home, erase to end of 
screen, erase to end of line, direct 
cursor addressing, and line feed, 


‘See Table 4-10 for the individual characteristics set by RSTS/E. 
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Table 4-9A (Cont.) 
RSTS/E TTY SET Commands 


Terminal is not a CRT display device. The 
system echoes a DEL character (RUBOUT) 
by printing a \ character and the last 
character typed and removes the last 
character typed from the terminal input 
buffer. Subsequent DEL characters cause 
the next to last characters to be sequen- 
tially printed and removed from the 
terminal input buffer until a character 
other than DEL is received. Asa result, 
the system echoes another \ character 

to delimit the erased characters and 
echoes the correct character. 


NO SCOPE 


Standard 
Condition 


See Note I 


Terminal transmits the full ASCII character 
set and system does the following: 


Recognizes only the ESC character 
CHR$(27) as an escape character, 


Echoes and uses the | CHR$(125) 
and ~ CHR$(126) characters without 
translation, and 


Echoes and uses lower case alpha- 
betic characters without translation. 
NO LC INPUT System treats ESC, } and ~ characters 
(CHR$(27), CHR$(125), and CHR$(126) 
respectively) as escape characters and 

translates lower case characters received 
to their upper case equivalents. 


NO FILL 


System does not generate fill characters 
for any characters transmitted. 


FILL LA30S 


Set the fill characteristics for a serial 
DECwriter (LA30S). 


FILL n Set the fill factor to n for this terminal 
where n is between 0 and 6. Asa result, 
the system generates a multiple of the 
default number of fill characters for each 
hardware control character it transmits. 
See Section 4.5.3 for a discussion of 


generalized fill characters. 


‘See Table 4-10 for individual characteristics set by RSTS/E. 
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Table 4-9A (Cont.) 
RSTS/E TTY SET Commands 


Set to n the rate at which the terminal's 
interface can accept or pass characters. 
The value for n can be any number de- 
fined for the keyboard number in the 
system file TTYSET.SPD. 


Standard 
Condition 


See Note 2. 


SPEEDn! 


SPLIT SPEED i/o! Set to i the rate at which the terminal's 
interface passes input to the computer 
and set to o the rate at which the ter- 
minal's interface accepts output from 
the computer. The values i and o must 
be defined for the keyboard number in 
the system library file TTYSET SPD. 


NO PARITY System ignores the parity bit on 
characters it receives and treats 
the parity bit on characters it trans- 
mits to the terminal as if it were a 
data bit. 


EVEN PARITY System sends characters to the terminal 
with the parity bit properly set for even 
parity but ignores the parity bit on 
characters received. 


ODD PARITY System sends characters to the terminal 
with the parity bit properly set for odd 
parity but ignores the parity bit on 
characters received, 


STALL Terminal obeys synchronization standard. 
If the terminal sends an XOFF character 
(equivalent to the CTRL/S combination), 
the computer interrupts transmission until 
the terminal sends either an XON 
character (equivalent to the CTRL/Q 
combination) or any other character. If 
the system receives an XON character, 


Pret commands can be used only on lines whose interfaces can be programmed to handle 
more than one speed (e.g., DCI1, DHI1). 


Pees Table 4-10 for individual characteristics set by RSTS/E. 
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Table 4-9A (Cont.) 
RSTS/E TTYSET Commands 


Standard 
Command Function Condition 


STALL (cont.) it does not keep that XON character as 
data, If the system receives another 
character, it resumes transmission and 
keeps that character as data. No 
characters are lost. 


XON and XOFF characters sent by the 
terminal have no special meaning. 


System echoes a control and graphic 
character combination as the t or 
characters (CHR$(94)) followed by 
the proper graphic. For example, 
CTRL/E prints as +E or AE. 


NO UP ARROW System echoes control and graphic 
character combination as is. 


DH BURST n Set to n the number of characters 
which a DH11 multiplexer assembles 
to transmit in a single burst. N 
can be between 1 and 30 and applies 
only to terminals on DH11 line 
interfaces, 


ESC SEQ System treats an ESC character 
. CHR$(27) and the next incoming 

character as an escape sequence. 
The system does not echo either 
character, but translates the 
CHR$(27) to CHR$(155) and 
reverses the characters. If the 
user executes a GET statement, 
the buffer contains the second 
character followed by the 
CHR$(155) character and 
RECOUNT is 2, 
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Table 4-9A (Cont.) 
RSTS/E TTY SET Commands 


Function 


System treats an ESC character CHR$(27) 
as a line terminating character and echoes 
it as a § character. 


Standard 
Condition 


See Note 1. 


NO ESC SEQ 


Terminate a program and return control 
to the monitor. 


Print a listing of single and macro 
commands, 


1 


See Table 4-10 for individual characteristics set by RSTS/E. 
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Table 4-9B 
RSTS (Version 4) TTYSET Commands 


Standard 
Command Function Condition 


Exit from the TTYSET program; return 
control to RSTS-11 Monitor, 


Print a description of the other 
TTYSET commands. 


Enable hardware tab control by the 
terminal (significant for ASR-35 
Teletypes). 


Disable hardware tab contro! by 
the terminal (significant for 
ASR~=35 Teletypes). 


Enable hardware form feed control 
by the terminal (significant for 
ASR-35 Teletypes). 


Disable hardware form feed control by the 
terminal (significant for ASR-35 Teletypes). 


Enable input of lower case letters 
(useful with some terminals, 
ignored by others). 


Translate all lower case letters sent 
by the terminal into upper case 

letters. 
XON Enable XON/XOFF remote low- 
speed reader control. 


NO XON Disable XON/XOFF remote 


low-speed reader control, 


ECHO Enable terminal echo facility; 


results in full duplex mode operation. 


NO ECHO 


Disable terminal echo facility; 
results in half duplex mode operation. 


Enable terminal CRT cursor controls 
(only significant when issued from a 
CRT display terminal). 


SCOPE 


NO SCOPE 


Disable terminal CRT cursor controls. 


Table 4-9B (Cont.) 
RSTS (Version 4) TTYSET Commands 


Standard 
Command Function Condition 


ESC Treat only ASCII 033 (octal) code as 
ESCAPE (ESCAPE or ALT MODE key). 


Treat ASCII 033, 175, 176 (octal) as 
ESCAPE (ESCAPE or ALT MODE 
key). 


Set the terminal form width to n WIDTH 72 


characters where I<n<254 (octal). 


WIDTH n 


SPEED n Set DC11 baud rate to DC11 speed SPEED @ 
n where O<n<3, The actual baud 
rate corresponding to n depends 

upon the hardware setting of the 


particular DC11 line referenced. 


Set fill factor of n, which is 
multiplied by the default fill 
factor. See Appendix B of the 


RSTS-11 System Manager's Guide. 


Set fill factor of 0. 


NO FILL 


FILL LA30 


Set special LA30 serial (DECwriter) 
fill factor. 


KSR33 
ASR33 
KSR35 
ASR35 
VT05 
VT06 
LA30 
LA30S 


Treat terminal as though it were the 
indicated device. These commands 
automatically select, from the pre- 
ceding commands, those features 

applicable to the respective terminal. 


In addition to the commands described in Table 4-9, TTYSET in RSTS/E allows the user 


to set all the individual characteristics for a certain type device by executing one command 
called a macro command. Each macro command assigns predefined characteristics, any of 
which can be altered in turn by proper use of an individual characteristics command. 


Table 4-10 describes the default values for each macro command, 


4-4] 


Table 4-10 


Default Single Characteristic Settings 


individual Macro Command 


cy-b 


pide a ee ee ee ee ee 
Se 


WIDTH n 72 72 
TAB/NO TAB NO TAB NO TAB TAB TAB TAB 
FORM/NO FORM NO FORM | NO FORM| FORM 


LC OUTPUT/ NO LC NO LC NO Lc 
NO LC OUTPUT | OUTPUT OUTPUT OUTPUT 


XON/NO XON XON NO XON XON 


LOCAL ECHO FULL FULL FULL “FULL 
FULL DUPLEX DUPLEX DUPLEX | DUPLEX DUPLEX 


SCOPE/ NO NO NO NO 
NO SCOPE SCOPE SCOPE 


LC INPUT/ NO LC NO LC 
NO LC INPUT INPUT INPUT 


NO LC LC 
OUTPUT | OUTPUT 


FULL 
DUPLEX 


SCOPE 


NO LC 
INPUT 


FILL n g 
FILL LA30S 


SPEED n 
SPLIT SPEED i/o 
2741 


NO PARITY 
EVEN PARITY 
ODD PARITY 


STALL/ 
NO STALL 


UP ARROW 
NO UP ARROW 


DH BURST h 


ESC SEQ/ 
NO ESC SEQ 


NO STALL | NO STALL 


72 80 
TAB NO TAB 


LC NO Lc 
OUTPUT | OUTPUT 


FULL FULL 
DUPLEX DUPLEX 


SCOPE NO 
SCOPE 


NO LC 
INPUT 


NO LC 
INPUT 


3 g 


15/2400 


80 
NO TAB 


NO LC 
OUTPUT 


FULL 
DUPLEX 


NO 
SCOPE 


NO LC 
INPUT 


FILL 
LA3@S 


3 


130 
TAB 


FORM |NO FORM | NO FORM! NO FORM| NO FORMINO FORM 


LC 


OUTPUT 
NO XON; NO XON/ NO XON | NO XON| NO XON] NO XON 


FULL 


DUPLEX 


NO 
SCOPE 


Lc 
INPUT 


80 
TAB 
NO FORM 


NO LC 
OUTPUT 


NO XON 


FULL 
DUPLEX 


SCOPE 


NO tc 
INPUT 


g 


398/96 98 


NO PARITY 
STALL 


NO UP 
ARROW 


12 


NO ESC 
SEQ 


32 
NO TAB 
NO FORM 


NO LC 
OUTPUT 


NO XON 


FULL 
DUPLEX 


NO 
SCOPE 


NO Lc 
INPUT 


1 


11g 


EVEN 
PARITY 


NO STALL 


NO UP 
ARROW 


30 


NO ESC 
SEQ 


132 
NO TAB 
NO FORM 


LC 
OUTPUT 


NO XON 


FULL 
DUPLEX 


NO 
SCOPE 


LC 
INPUT 


1 


3 


NO PARITY 
NO STALL 


UP 
ARROW 


30 


NO ESC 
SEQ 


The TTYSET program under RSTS/E checks commands before and during execution and 
reports errors by printing the messages described in Toble 4-11. If any errors involve the 
terminal speed file, the user should immediately notify the system manager or responsible 


system programmer. 


Table 4-11 


RSTS/E TTYSET Error Messages 


| Message | Meaning | 


<string> IS AN ILLEGAL KB The keyboard number denoted by<string>is not between 
SPECIFICATION @ and 63 or is not a valid number. 


ILLEGAL FILL FACTOR Fill factor specified is not between @ and 6, 


ILLEGAL WIDTH Width specified is not between 1 and 254, 
ILLEGAL DH BURST Burst must be between 1 and 30. 
COMMAND <string> ILLEGAL | Command indicated by <string> is undefined. 


ILLEGAL SPEED Speed given is not one defined for the device in the 
$TTYSET.SPD file. 


WARNING - ERROR READING | Program wams user of possible corruption in the terminal 
$TTYSET SPD FILE speed file and denotes the exact error by printing the 
COMMAND ERROR message. 


COMMAND ERROR - <text> The RSTS error denoted by <text> was encountered when 
executing the command. 


ERROR -<text> The RSTS error denoted by <text>was encountered when 
executing the system function to change terminal status. 


WARNING - CANNOT OPEN | Program could not access the terminal speed file 
$TTYSET.SPD FILE and denotes the exact error by printing the COMMAND 
ERROR message. 
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4.5.1 ESCAPE, ALTMODE, and PREFIX Characters 


The RSTS-11 system translates certain ASCII characters in a special manner. Some 
terminals have the outmoded ASCII character keys ALTMODE (125 decimal) and PREFIX 
(126 decimal). More recently designed terminals incorporate the 1968 ASCII character 


set and include the following control characters: 


ESCAPE = 27 (decimal) 
} =125 (decimal) 
~ = 126 (decimal) 


The RSTS-11 system interprets CHR$ (27) as a line terminating character and automatically 
translates any CHR$ (125) and CHR$ (126) characters input from a terminal into 27 (decimal). 


The system thus treats 125 (decimal) and 126 (decimal) as line terminators. 


A user having a terminal with the 1968 ASCII character set can make the system treat 
125 (decimal) and 126 (decimal) characters as they are printed rather than as control charac- 
ters. The TTYSET commands LC INPUT and NO LC INPUT alter internal parameters for a 
given terminal so that the system treats 125 (decimal) and 126 (decimal) as they are printed 


or translates them automatically . 
4.5.2 Lower and Upper Case Characters 
Some terminals can send and print both lower case and upper case characters. Such 


terminals can therefore print the echo returned by the system to give the user an accurate 


visual representation of the character transmitted. 


lon Version 4 (RSTS) systems, the selectable ALTMODE translation option must be included 
on the system and the ESC and NO ESC commands must be used to alter the internal parameters. 
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Terminals such as the VT05 alphanumeric display can send either lower case or upper 
case characters but can print only upper case characters. Consequently, the echo response 
of such a terminal to a lower case character is the upper case counterpart. The terminal 


gives the user no visual indication that the character transmitted was a lower case character. 


Terminals such as the ASR-33 and KSR-33 type devices neither send nor receive lower 
case characters. If such a terminal receives a lower case character, it prints the corresponding 


upper case character. 


Normally, RSTS-11 software translates ail lower case characters to their upper case 
counterparts before processing them. To take advantage of different features of terminal hard- 
ware, a RSTS/E user chooses or omits lower case translation depending upon whether the termi- 
nal produces lower case output, lower case input, or baits! The LC OUTPUT and LC INPUT 
commands, respectively, omit translation of lower case characters generated as output on and 
input from a terminal. NO LC OUTPUT causes lower to upper case translation on output to the 


terminal; NO LC INPUT causes lower to upper case translation on input from the terminal. 
4.5.3 Generalized Fill Characters 


The RSTS-11 system automatically generates a variable number of NUL characters 
(CHR$(0%)) as fill characters after processing certain control ehaiadteis’ The generation of 
the meaningless NUL characters allows the terminal sufficient time to complete the physical 
action initiated by the control character and permits the terminal to synchronize itself properly 
for printing the next meaningful character, The control characters and the related default 


number of fill characters generated are shown in Table 4-12. 


lon Version 4 (RSTS) systems, the selectable lower to upper case translation option must be 
included on the system to be able to omit automatic translation. In addition, the LC and 
NO LC commands control automatic translation of all lower case characters, whether genera~ 
ted as input or output. 


2 : : é : ; 
On Version 4 (RSTS) systems, the terminal fill option must be included on the system for the 
automatic generation of fill characters to occur. 
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Table 4-12 
Control Characters Requiring Fills 


Default 
Control Decimal Number of NUL 
Characters Value Characters Generated 


CR (RETURN) 


Since the default number of fill characters is appropriate only for a terminal operating 
at 110 baud, the user must alter the number of NUL characters generated as fill for a 
terminal operating at a speed greater than 110 baud. The TTYSET commands FILL and 
NO FILL selectively generates multiples of the default number of NUL characters or 
disables automatic generation of NUL characters, The multiple is called the fill factor. 
If the user types the FILL 2 command, the system subsequently generates twice the number 
of default NUL characters - 2 NUL characters after CR, LF, and HT characters; 8 NUL 
characters after VT characters; and 18 NUL characters after FF characters. To disable 
the generation of fill characters, the user can type the NO FILL command which effectively 


sets the fill factor to 0. 
4.5.4 XON/XOFF Remote Reader Control 


To operate a low speed paper tape reader connected to the RSTS-11 system by either 
a data set (dial up) or a communications line, two requirements must be fulfilled as 


bellows! : 


a. The terminal must be equipped with the requisite hardware option for 
XON/XOFF remote reader control 


b. The XON/XOFF code must be enabled for the given terminal. 


lon Version 4 (RSTS) systems, the XON/XOFF remote reader control option must be included 
on the system at system generation time to operate a low-speed paper tape reader as described. 


The user can selectively enable and disable remote reader control for a remote terminal by 


the TTYSET commands XON and NO XON, 


For low speed readers connected to the system by a local line interface, none of these 


requirements is necessary. 


4.5.5 Output Parity Bit 


DEC-supplied terminals are normally wired to send non-parity characters and to ignore 
the parity bit on characters received. Consequently, the RSTS-11 software normally ignores 
the parity bit on characters received from a terminal and omits the parity bit on characters it 


|. Since some terminals not suppled by DEC can receive even or odd parity characters, 


transmits 
the software must be conditioned to send parity characters. The TTYSET commands EVEN 
PARITY, ODD PARITY, or NO PARITY condition the software to send the correct parity. 


The software ignores parity bits on characters input to the system, 
4.5.6 SET as a CCL Command 


Under a standard RSTS/E system, the user can execute TTYSET by the correct concise 
command language (CCL) command. To execute a CCL command, merely include a valid 


TTY SET command following the proper CCL command. For example, 


SET ASR33 
READY 


For more information on CCL commands, see the introductory material for Chapter 4. 


1 ; . , : 
On Version 4 (RSTS) systems, the no parity option must be included on the system at system 
generation time if the software is to automatically omit the parity bit on characters it transmits. 
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4.6 QUOLST PROGRAM 


The QUOLST system program allows the user to determine what portion of his disk quota 


is currently occupied and the number of free blocks remaining on the system disk. QUOLST is 


called as follows: 
RUN$ QUOLST 


Output from QUOLST includes the user account number and information printed under the 


following headings: 


Table 4~13 
QUOLST Column Headings 


Column Heading Meaning 


STR STRucture, device being reported . 

USED number of used 256-word blocks under the user account. 

FREE number of free blocks remaining in the user account disk quota . 

SYSTEM number of free blocks remaining to the system on the structure 
indicated . 


Output from QUOLST looks as follows: 
RUN $QUOLST 


USER: [160,100] 

STR USED FREE SYSTEM 
DF: 55 145-1234 
DKI: 1g 1992 1992 


In this example, the user is logged into the system under account [1@@, 108] and has 
used 55 blocks on the system disk(s) with a quota of 268 blocks (200 -55=145 free blocks). 
There are 1234 free blocks on the system disk(s). User [180,188] also has access to private 
disk DK1: He has used 1@ blocks on DK1: and has no disk quota on that device; therefore, 


the free user block count is equal to the free system block count (1992 blocks). 
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4.7 MONEY PROGRAM 


MONEY is the RSTS-11 system accounting program which allows a user to obtain 


printed data on his own account status. The program is called as follows (only by a user 
logged into the system): 


RUN$ MONEY 


The following shows Teletype output resulting when a user logged into the 


under account [100,100] runs the program MONEY: ! 


system 


RUN $MONEY 


ACCT  FASSHORE CPU-TIME 
a. 28 2.5 124 z a a 400 
READY 


'On Version 44-12 systems, MONEY prints an ACCESS column which gives two numbers: 
the number of logins and the number of logouts. 
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KCT’S CONNECT CEVICE CISK GuUCTA 


UF Es 
1é 
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4.8 GRIPE PROGRAM 


The GRIPE system program allows a user to communicate comments to the system manager. 
Comments which the user types while running GRIPE are written to a common file where they 


are retained for inspection by the system manager. 
The user runs GRIPE by typing the following command, 
RUNSGRIPE 
GRIPE indicates that it is ready to accept user comments by printing a query line as follows: 
YES? (END WITH ESCAPE) 

The user is then allowed to type the text of his comment which is entered into the common 
file, The user terminates the text of his comment by typing the ESCAPE or ALTMODE key. 
(Typing the ESCAPE or ALTMODE key is echoed at the terminal by a dollar sign ($) being 
printed. No carriage return-line feed operation is performed. The program indicates its 


acceptance of the text and its termination by printing the following lines. 


THANK YOU 
READY 
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4.9 EDIT PROGRAM! 


The EDIT system program is used to prepare and modify text or program files. It can be 


run by any user. To run EDIT, the user types: 


RUN $EDIT 
EDIT V@5-93 


# 


In response to the number sign (#), the user must specify the input files he wishes to 


modify and the files to be created as output. The form of this specification is: 
#OUTI,OUT2<IN1, IN2/B 


where INI and OUTI are the primary input and output files, respectively, and IN2 and OUT2 
are the secondary input and output files. These file names may be any valid RSTS-11 file 
specifications, including a device, name, extension, project-programmer number, and 
protection code. The "/B" is included if the user desires to edit a BASIC-PLUS program file 
containing LINE FEED continuation of lines. (See the BASIC-PLUS Language Manual, 
Section 2.3.2.) Of these file specifications, only the primary output file, OUTI must be 


included, This file alone being specified is used to indicate the creation of a new file. 


If IN] and OUTI, the primary input and output, are specified as the same file, the 
primary input file will be renamed after the editing is complete to have an extension of BAK, 
the "backup" file. In this case EDIT will use a temporary name of EDITnn.TMP for the 
primary output file during editing operations (where "nn" is the job number under which EDIT 
is being executed), If the secondary output file is a line printer (LPn:), the printer will only 
be assigned when needed for output. (If the printer is unavailable when needed, the user is 


given the option of waiting for some time of his choosing or of aborting the output request.) 


Once EDIT has been given the file specifications, it will open the necessary files and 
respond with an asterisk (*), indicating it is ready to accept editing commands from the user. 
The valid commands are as described in the PDP-11 Edit-11 Text Editor Programmer's Manual, 


DEC-11-UEDAA, and are summarized in Table 4-14 here. 


] 
The EDIT program is not available prior to Version 5B(RSTS/E) systems, 
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The EDIT-11 command T (trailer) has no meaning to the RSTS-11 EDIT program. All 
other descriptions of EDIT-11 commands and how they operate are valid for RSTS-11 EDIT 
as well. If an error occurs in executing a command as typed by the user, the command 
already executed will be printed, terminated with a question mark (?) at the point at which the 
error was noted. When editing is complete, EDIT returns to the request for file specifications 


@). 


4.9.1 EDIT as a CCL Command! 
EDIT may be run as a CCL command by typing one of the following: 


1) EDIT 

2) EDIT OUT1,OUT2 <IN1,IN2 
3) EDIT FILENAME 

4) CREATE FILENAME 


The first of these is equivalent to: RUN $EDIT. The header line is printed, and a # 
character prompts the user to specify his files, The second CCL command, shown above, 
runs EDIT and also automatically sets up the input and output files as specified. No header 


line is printed. 
The third CCL command is equivalent to the set of commands: 


RUN $EDIT 
FILENAME <FILENAME/B 
R 


except that the header line of EDIT is not printed. EDIT runs, sets up a .BAK file, reads the 
first buffer, and waits for the user to type editing commands. 


The last CCL command shown above sets up the file named FILENAME as an output file. 
No .BAK file is set up; there is no input file; and no header is printed. If the file existed 
previously, it is reduced to zero length. As a first command, type | (insert). The CREATE 


command is equivalent to the instructions: 


RUN $EDIT 
FILENAME 


I). , . F : 
This feature is not available prior to Version 5B (RSTS/E) systems. 
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Table 4-14 
Summary of EDIT Program Commands 


Read Read from primary input file until form feed is 
encountered or all internal buffer space is filled. 


Edit Read Read from secondary input file until form feed is 
encountered or all internal buffer space is filled. 


Write Write n lines into primary output file, starting 
from the current position Dot. 


Edit Write Write n lines into secondary output file, starting 
from the current position Dot. 


Next nN Write the contents of the Page Buffer into the 
primary output file, kill the buffer, and read a 
page of text from the primary input file. Repeat 
n times. Equivalent to BAW /DR. 


Form feed nF Insert n form feed characters at Dot. 

Beginning B Move Dot to the beginning of the Page Buffer. 

Advance nA Advance Dot n lines, Leaves Dot at beginning 
of line. 

Jump nJ Move Dot over n characters. 

Delete nD Delete n characters from text, starting at Dot. 

Kill nK Kill n lines of text, starting at Dot. 

Mark M Mark the current location of Dot. 

Save nS Save the next n lines in the Save Buffer, starting 
at Dot. 

Unsave U Copy the contents of the Save Buffer into Page 


Buffer at Dot. 


List nb List n lines on teleprinter, starting at Dot. 
Verify Vv Verify the present line via teleprinter. 
Get nG #XXXXX# Search for the nth occurrence of XXXXX, 
or Return with Dot following XXXXX. 
nG <CR> 
XXXX<CR?> 
<LF > 
wHole nH#XXXXX# Search for the n' occurrence of XXXXX. If 
or found on this page, return with Dot following 
nH <CR> XXXXX._ Hf not found, execute an N command 
XXXX <CR > and continue search, 
<LF > 


1 
In the table, # represents any ASCII character. <CR> represents a return character, and 
<LF> represents a line feed character. 
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Table 4-14 (Cont.) 


Summary of EDIT Program Commands 


Edit wHole nEH#XXXXX# Perform a wHole search for the a occurrence 
or of XXXXX, using the secondary input and 
nEH <CR> primary output files. 
XXXX< CR > 
<LF> 


Position nP#XXXXX# Perform a Next command, then search for the 
or n- occurrence of XXXXX._ If found, return 
nP<CR> with Dot following XXXXX. If not found, 
XXXX< CR > clear the buffer, read another page, and 
<LF> continue search. 


Edit Position nEP#XXXXX# Perform a Position search using secondary input 
or rather than primary input file. 
nEP<CR > 
XXXX <CR > 
<LF> 


Insert tEXXXXX# Insert the text XXXXX at Dot. Move Dot to 
or follow XXXXX, 
1 <CR> 
XXXX<CR> 
<LF> 


nC#XXXXX# Change n characters starting at Dot to XXXXX. 
or Equivalent to Insert followed by n Delete. 

nC <CR> 

XXXX <CR > 

<LF> 


nX#XXXXX# eXchange n lines starting at Dot for XXXXX, 
or Equivalent to Insert followed by n Kill. 

nX <CR> 

XXXX <CR > 

<LF> 


Execute Macro nEM Execute the first line of the Save Buffer as 
a command string n times. 


Exit EX Perform consecutive Next commands until 
end of primary input file is reached, Close 
all files, and return to file specification request. 


Edit Open Move to beginning of the secondary input file. 


End File Close the primary output file to any further 
output and close the primary input file. 


Tin the table, # represents any ASCII character. <CR> represents a return character, and 
<LF> represents a line feed character. 
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4.10 BACKUP PROGRAM | 


The BACKUP system program is employed on-line to preserve and recall files stored under 
one user account or under several user accounts. It provides a means of transferring multiple 
files from a private disk or from the public disk structure to a private disk, to a magtape, or 
toa DECtape. BACKUP also provides the means of later transferring those files back to the 
original device. To run, BACKUP requires that the Record |/O software option be included 
in the system configuration, The BACKUP program and its related program BACKDK are stored in 
their compiled forms in the system library with protection code <104 >, 
actually performs the transfer operations. A command typed to BACKUP is parsed and 
passed to error checking routines. Most error reporting and checking for file and account 
protection violations are done by BACKUP. When no errors are detected in the command, 
BACKUP writes the valid, parsed command to the core common area and chains to the 


BACKDK program in the system library. 


BACKDK runs and transfers the designated files according to options given in the 
command, File protection code and cluster size information is preserved for all files 
except for those transferred to and from DECtape. Before transferring a file to disk or to 
DECtape, BACKDK performs an OPEN FOR INPUT operation to determine if a file of the 
same name and extension currently exists. Unless the user specifies otherwise in the BACKUP 
command, BACKDK does not transfer the file if it currently exists on the output disk or 
DECtape device. BACKDK transfers files to magtape without checking for the current 


existence of the files. 


Any protection violation errors encountered when transferring a file causes BACKDK to 
print the INTERLOCK error message, to skip the file, and to proceed without interruption. 
Files open in UPDATE mode while BACKDK is running are not transferred. When an end of 
device occurs during transfers to or from magtape, BACKDK allows the user to continue 
with another reel. If a fatal error occurs during a transfer, BACKDK prints the related 


error message and chains to the BACKUP program. 


dai feature is not available prior to Version 5B (RSTS/E) systems and is not available on 
Version 4B (RSTS) systems. 
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Both privileged and non-privileged users can run BACKUP. BACKUP interprets all requests 
by a non-privileged user as applying to the account under which the program is currently running. 
Only those files stored in his account are affected. In addition, the date of creation and date 
of last access information for files transferred by a non-privileged user are always reset to the 
current system date. (Technically, BACKUP always enables the /B option for a non-privileged 
user.) Also, a non-privileged user can not transfer a compiled (run-only) file. If a non- 
privileged user attempts to transfer a compiled file, BACKDK prints the PROTECTION 
VIOLATION error message and proceeds to the next file. 


A privileged user can specify a project-programmer field in a command. This facility 
allows him to transfer files stored under accounts and to specify multiple accounts in a single 
transfer request. Date of creation and date of last access information is preserved for files 
transferred by a privileged user unless he specifies the /B option. BACKUP provides several 
options which can be executed only by a privileged user. These options are described in 
Section 4.10.7. 


BACKUP uses a command string similar to the PIP system program and can be considered 
a superset of Record I/O PIP. BACKUP performs no format checking and, consequently, 
generates no error if, for example, a request is made to transfer a binary file to a character 


oriented device such as the line printer. 
4.10.1] Running and Terminating BACKUP 


The BACKUP system program is run from a terminal logged into the system by typing 


the following command, 


RUN $BACKUP 


When BACKUP runs, its prints a header line containing the program name and version number, 


followed by the pound sign (#) character as shown below. 


FILE BACKUP V@5-23 
oa 


The user can type a command string to BACKUP any time BACKUP prints the # character. 


Typing acommand string beginning with H causes a help message to be printed at the terminal, 
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The user terminates BACKUP by typing either the CTRL/C or CTRL/Z combination in response 


to the # character printed at the terminal. 


#4 Z 
READY 


The system indicates the termination of BACKUP by printing the READY message. 
4.10.2 BACKUP Command Specification 


The BACKUP system program accepts a command string similar to that accepted by the 
PIP system program. Commands must be typed on a single line and contain no more than 80 
characters. Spaces, tabs, and commas are ignored by the program but included in the 80- 


character limit. A command to transfer files has the following general form: 


# output specification <input specification/options 
The file or files designated by the input specification are transferred to the output device. 
The output specification consists of either a valid device and unit designator or no specification. 
Giving an account number in the output specification is not valid but generates no error. 


Omitting the output device causes BACKUP to use the public disk structure. 


Valid device designators are the same as those defined for the input specification in 
Table 4-15, The additional output device is allowed: line printer units @ through 7 
(LP@: through LP7:), One output specification is allowed per command. The left arrow 


character (<) separates the output specification from the input specification. 
The input specification is of the following form: 
dev:<dev:|[proj ,prog]filename. ext 


The elements of the input specification are described in Table 4-15. One input specification 
or no input specification is allowed for each BACKUP command. No input specification 
indicates all files on the public disk structure for the current user account. The [proj, prog] 
designation is valid for privileged users only. For non-privileged users, BACKUP automatically 
changes any [proj, prog] designation given in an input specification to the project-programmer 


number of the current account, 
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Table 4-15 
BACKUP Input File Specification Elements 


cr 


(proj ,prog] [208 , 200) 
[*, 209] 


Project- User account number, 
programmer 


field 


The appearance of an asterisk means 
that files for either all project 
numbers or all programmer numbers 
or both are designated for the 
transfer, Never can be [@, 1]. 

If null, files for only the current 
account are transferred, 


Device 
designator 


DK@: to DK7; RK@5 or RKG3 DECpack units ¥ 
through 7 

RP@3 disk pack units 8 

through 7 

DECtape units @ through 7 
Magtape units % through 7 
Public disk structure 


DP@: to DP7; 


DT@: to DT7: 
MT@: to MT7: 


null 


Filename An asterisk in the filename FILE.BAS 


and extension | filename. ext specification means all filenames; FILE. * 
filename, * in the extension specification, * BAS 
all extensions (including filename ae 


with no extension). The con- 
ventional explicit filename and 
extension specification is also 
recognized, Null is equivalent 

to specify all files (*,*). 

The question mark character in any 
position of either a filename or 
extension specification or of both 
means that any alphanumeric 
character can be substituted for 

the ? to designate a file to trans- 
fer. In this manner, files with 
similar filenames and extensions 
can be easily designated for backup 
or recall, 


file? ? .ext 
file,e?? 
file? ?.e?? 


FILE? ?.BAS 
FILE.B?? 
FILE? ?.B 
? FILE, ?A? 


file? ?.* 
* ex? 


FILE? ?.* 
* BA? 


The asterisk and question mark can 
be used together. 


Protection codes are transferred in 
all transfers except those involving 
DECtape. Files cannot be trans- 
ferred conditionally based on 
protection code, 


Protection 


Code 
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One or more BACKUP options can be specified following the input specification or can 


appear as a command by itself. An option is specified in the following general format: 
/option:argument:argument 


An option always begins with a slash character (/) and terminates with another slash (the 
start of another option) or terminates with a line terminating character (RETURN). The 


options are listed and described in Table 4-16 (next page). 


4.10.3 Magtape Characteristics 


Magtape devices are non-directory oriented. The system writes only contiguous files to 
magtape and writes new files following those files currently on the reel. Therefore, the 
BACKUP program cannot replace an older version of a file on magtape with a newer version 
and cannot selectively delete files currently written on magtape. Asa result, the /S and 


/D:dd-mm-yy options have no effect when the input device is magtape 


Immediately following the last file written on a magtape are three end of file (EOF) 
marks. When the user specifies magtape as the output device, BACKUP reads the magtape 
until it detects the standard three consecutive EOF marks. The program then backspaces 
and writes the first file over the last two end of file marks. The program writes files until the 
end of tape is sensed, after which it backspaces to the last EOF mark, writes 3 EOF marks 
to signify the end of tape, and prints a message allowing the user to continue output to another 


reel on another unit or on the same unit, 


Since files with the same filename specifications can exist on a magtape reel, the user 
must exercise care when he transfers files to magtape. It is suggested that the user zero the 
magtape before transferring files to it. To do this, he can specify the /Z option in the BACKUP 
command. When the user specifies the zero action, BACKUP writes 3 consecutive EOF marks 


after the beginning of the tape and begins the transfer at the beginning of the magtape, 


BACKUP maintains additional information in the standard 7-word file label record on 
magtape. Byte 9 contains the cluster size minus 1 of the file and bytes 12 and 13 contain 
the date of last access for the file. These bytes are not used by the RSTS-11 magtape file 
system. However, DOS magtape expects these bytes to be zero, so a BACKUP magtape 


may not be readable under DOS. 
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Table 4-16 
BACKUP Options for General Usage 


Transfer only those files having a creation date greater 
than or equal to the date specified by dd-mmm-yy. For 
example, /C:12-JAN-74 transfers only those files with 
a creation date on or after January 12, 1974. 


/C:dd-mmm-yy 


/A 
/A/Lidevice 
/A/L:filename.ext 


Prints a directory listing at the user's terminal, 
Prints a directory listing at the device, 

Prints a directory listing in the file specified in the /L 
option, BACKUP performs no transfer. 


/D:dd-mmm-yy Delete those files on the input device after the transfer 
if their dates of last access are less than the date specified 
by dd-mmm-yy. For example, D:12-JAN~-74 deletes those 


files whose date of last access in January 11, 1974 or before, 


Selectively transfers files by account number (1:A) for 
privileged users or by filename (I:F) for general users. 
BACKDK prints each account and/or each filename 
eligible for selection and asks the user if he wishes to 
perform a transfer. Specifying /I indicates selection by 
account and filename (I:A:F). Can be used with the /V 
option as well as with transfer of multiple files or accounts, 


/L 
/Lidevice 
/L:filename.ext 


Prints listing information at the user's terminal, 

Prints listing information at the device indicated. 

Prints listing information in the file specified (L:filename,ext). 
A disk device or protection code can be included in the file 
specification (L:DK1:FILE.LST<40>), 


/R 


Used only for recall of files from DECtape. Prevents 
lengths of files created by BACKUP from inflating 


unnecessarily, 


Supersedes currently existing files on DECtape or disk 
with files of same name on the input. BACKUP does not 
ordinarily supersede existing files. 


Reads each block of each file specified on the device 
indicated. No transfer is performed. Verifies accessibility 
of files by determining whether they contain bad blocks, 


Equivalent to the /ZE option of the PIP system program, 
User must type Y or any string beginning with Y in 

response to the REALLY ZERO query to perform the zero 
action, 


4-64 


4.10.4 Disk Characteristics 


The user can employ a private disk pack to preserve files of the public disk structure. The 
DECpack or disk pack must be logically mounted and in the UNLOCK state before BACKDK 
can write files to or read files from the pack. Each account on the public structure from which 
or to which BACKDK transfers files must exist on the private pack. If an account does not 
exist on the private disk pack, the files of that account are not transferred. BACKDK reports 


the RSTS~11 error number 5 and continues processing any further accounts. 


Since disk is a directory oriented device, the BACKDK program must search an account 
directory for the existence of each file transferred, BACKDK usually does not transfer a file 
from the input device if a file of the same filename and extension currently exists on the output 
disk under the same account. BACKDK simply omits the transfer, flags the file with the ALREADY 
EXISTS message, and proceeds to the next file. To have BACKDK supersede currently existing 
files on the output device, the user must specify the /S option in the command to BACKUP. 


BACKDK can not transfer files which are open in UPDATE mode. 
4.10.5 DECtape Characteristics 


DECtape is a directory oriented device as is disk. A directory entry on DECtape maintains 
filename, filename extension, length, and date of creation information. Date of last access, 
protection code, and project-programmer number information are not used when reading and 
writing DECtape under RSTS-11. Files from more than one account should never be transferred 
to the same DECtape reel if user account and protection code information are important. When 
transferring files from DECtape, BACKDK uses the account on the output device corresponding 
to the account under which the program is running, sets the protection code of each file to 60, 
and sets the date of creation, time of creation, and date of last access to the current system 
date and time. If a privileged user specifies a single account in the input specification 
project-programmer field when he transfers files from DECtape, the BACKDK program writes 


the files to that account on the output device, 
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All transfers to and from DECtape are performed on a packed block-by-packed block 
basis. Consequently, a transfer made from a disk to DECtape causes more blocks to be 
generated on the DECtape than originally existed on disk. Because of the smaller block size 
on DECtape (510 bytes per block), a file on disk requires a larger number of blocks when 
transferred to DECtape. For example, ten blocks on disk require ten blocks plus 20 bytes 


or eleven blocks on DECtape. 


Because of the smaller block size of DECtape, a disk file created by BACKDK on 
DECtape grows in length when transferred back to disk. Repeated transfers of disk files to 
DECtape and back causes the size of the file to increase although no additional information 
is added. To prevent unwarranted inflation in the size of a file created by BACKUP, use 


the /R option in the BACKUP command when recalling that file from DECtape. 


Do not use the /R option when recalling a file from DECtape if that file was not created 


by BACKUP. Information at the end of the file on DECtape can be lost. 


If BACKDK is transferring files to DECtape and the NO ROOM FOR USER ON DEVICE 
error occurs, the program prints an error message followed by an information message con- 
ceming the number of blocks and files transferred. BACKDK then chains to the BACKUP 
program which prints the pound sign character. An incomplete file and the directory entry 


for the incomplete file may exist on the DECtape. 


BACKDK omits transferring certain files to and from DECtape if those files of the same 
filename and extension currently exist on the DECtape. To supersede existing copies of files, 


the user must specify the /S option in the BACKUP command. 


Because BACKDK must search the directory on DECtape for each file transferred to or 
from DECtape, operations using DECtape tend to be slow. In addition, account information 
is not recognized on DECtape. For these reasons, DECtape is more beneficial to the general 
user who wants to preserve a relatively small number of files from one account, The maximum 
usable storage capacity on DECtape is 561 blocks, each 510 bytes in length. To preserve 
a large number of files from many accounts, magtape or private DECpack or disk pack is 


more advantageous. 
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4.10.6 General Usage of BACKUP Commands 


This section describes the general usage of BACKUP commands and options for both the 


privileged and the non-privileged user. 


To transfer all files from the current account in the public disk structure to a DECtape, 


the user can type a command similar to the one shown in the following sample dialog. 


ADT List e%/Z/L 2 BACKUP LST 


REALLY ZERO DT1: 7. Y 


TRANSFER COMPLETE 365 PLUCKS TRANSFERRED IN 14 FILES 
ee 


sis 


The /Z option causes BACKDK to print the REALLY ZERO query. To zero the device, the 
user must type Y or any string beginning with Y. If the user decides not to zero the device, 
he can type the RETURN key only or any string not beginning with Y. BACKDK prints 
listing information in the file BACKUP.LST on the system disk. Upon completion of the 
transfer, BACKDK prints the TRANSFER COMPLETE message and chains to BACKUP which 


prints the # character. 


To recall files created by BACKDK on DECtape, the user can type the following 


command, 


#SYi<DT1Li#.e*/R/LE RECALL «LST 
TRANSFER COMPLETE 365 BLUCKS TRANSFERRED TN 14 FILES 


The /R option prevents inflating the size of files created by BACKDK. Listing information is 
placed in the file RECALL.LST on the system disk. Asa result of the command, all files on 
the DECtape are transferred to the current user's account on the system disk. Those files 


currently on the disk are not superseded. 


To transfer certain files selectively to a magtape, use a command similar to the one shown 


in the following sample dialog. 
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#MT1L2<C%¥s*IPROG?? -*/Z/1/L3BACKUP+LST 
REALLY ZERO MT1l: ? Y 

Clli.»26]3?7 ¥ 

PROG@!.BAS? Y 

PROGAA-BAS? 


# 


The /Z option causes BACKDK to print the REALLY ZERO query. To zero the magtape, the 
user types Y or any string beginning with Y. Typing the RETURN key only or any string not 
beginning with Y causes BACKDK to search for the end of the last file on tape before 


beginning the transfer. The files on tape are not overwritten. 


The /I option causes BACKDK to print, as a query, the project-programmer number and 
file name of each account and file eligible for transfer. To include the item in the transfer, 
type Y or any string beginning with Y in response to the query. Typing the RETURN key 
only or any string not beginning with Y causes BACKDK to omit the item from the transfer, 
(For a non-privileged user, BACKDK prints the current account number as the only eligible 


project-programmer number.) Listing information is written to the file BACKUP.LST. 


If the end of magtape is reached, BACKDK prints the message NEXT MAGTAPE UNIT # 
after which the user must type a number between @ and 7 inclusive. This number designates 
the magtape unit on which the continuation reel is mounted. Subsequently, BACKDK con- 
tines transferring files to that reel. (If the user originally specifies the /Z option, BACKDK 
prints the REALLY ZERO message for each continuation reel .) 


The user can transfer files to a private disk by typing a command similar to the following 


command, 


#DK13<*.bAS/S 
TRANSFER COMPLETE 112 BLOCKS TRANSFERRED IN 4 FILES 
# 


The /S option ensures that BACKDK supersedes any files currently in the user's account on the 
disk with files of the same filename and extension from the system disk. The command in the 
sample dialog causes BACKDK to transfer all BASIC-PLUS source files to the private disk 
pack mounted in unit 1. Upon completion of the transfer, BACKDK prints the information 
message telling the number of blocks and files involved in the transfer and prints, on a sub- 


sequent line, the pound sign character. 
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To print the directory of a device, the user can specify the /A option as in the following 


command, 


#DTAL7A 
P1105 26 = PPN BEING LISTFD AT @2:21 PM 27-FEB-74 

DTAsSORT «HLP 7 27-FFE-74 01-AUG-73 42:21 PM A 
DTA:SURT .BAS 26 27-FER-74 @1-AUG-73 92:22 PM A 
DTASKGWIK «BAS 23 O7T-FER-74 @1-AUG-73 42:22 PM 
DTA:UOWIK «BAS 17 OT-FFE-74 B1-AUGC-73 2:22 PM @ 
DNT@:SGWIK «BAS 14 27-FEB-74 #1-AUG-73 92:22 FM A 
DPASMOWIK .« BAS 15 2I-FEP-74 A1-AUC-73 92:22 PM 1 
DTASKEY DMP. BAS 7 e2T-FEB-74 @1-4UG-73 82:22 PM BA 
DTA:MUKPIO.BAS 3 2I-FER-74 27-FEB-74 42:22 PM @ 
DTAsK *BAS 4 PT-FFRB<74 2P6-FER-74 42:22 PM A 
DT@: JIM «RAS 3 CT-FEB-74 26-FFF-74 @2:22 PM A 


LIST COMPLETF 119 RLOCKS LISTED IN 1€@ FILES 


# 


BACKDK prints an information line containing the project-programmer number of the current 
account and the current system date and time, followed, on subsequent lines, by a list of 
files. For each file, BACKDK prints the full file description, number of blocks, the date of 
last access, the date and time of creation if applicable (if not applicable, the current system 
date and time), and the cluster size of the file if applicable (0 if not applicable). For 
magtape and disk files, the protection code is also printed. At the end of the list of files, 
BACKUP prints a line containing the total number of blocks in the files listed and the number 


of files listed, followed by a line containing the pound sign character. 


To direct the output of a directory listing to another device or to a file, the user can 
type the /L option, specifying the desired device or file, and the /A option. For example, 


the following command, 


U/A/LDIR.SYS 


prints the directory listing of the current account on the system disk in the disk file DIR.SYS. 
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To verify readability of files on a device, the user can type the /V option. 


#DT1:* BAS/V 
VERIFY COMPLETE 121 BLOCKS IN 4 FILES 
ee 


BACKDK reads each block of every source file on DECtape unit 1 to ensure no errors. Upon 
completion, BACKDK prints an information message, followed by the pound sign character. 

If an error occurs, and the user requested the /L option, BACKDK records the data error, the 
file involved, and the block number in the file containing the error. (BACKUP treats a command 


without the /A option and without the left hand arrow (<) character as a verify request. 


The /C:dd-mmm-yy option allows a user to transfer files based on the creation date. 
The option can select certain files from files of the same name on magtape based on a creation 
date. The /D:dd-mmm-yy option can be used to keep the system disk clear of lesser used files. 


The option selectively deletes files on the source device after the transfer is completed. 


4.10.7 Privileged BACKUP Commands and Options 


A user running BACKUP under a privileged account can specify, on the input side of a 
command, the project-programmer field described in Table 4-15 and can use several privileged 


options described in Table 4-17, 


For a privileged user, BACKDK retains the date of creation and date of last access 
information when transferring files. The /B option causes BACKDK to reset the information 


to the current system date as BACKDK normally does for a non-privileged user. 


The /DET option causes BACKDK to run as a detached job. The user must not specify the 
/\ and the /L options with the /DET option since both options require printing at the terminal 
keyboard. However, the /L option with a filename can be specified. The /M option usually 
accompanies the /DET option when the output device is magtape. If /M is not specified with 


/DET, the job simply enters the HB state when it attempts to print a message. 
i ply pts to p 


The most valuable use of the privileged options is made when the user must transfer all 


files from the system disk to magtape, as is shown in the following command. 
#MT1:<[*, *]/Q/M/DET/L:BACKUP .SYS/Z 


All files in the public structure (including those in the system account @,1) are transferred 
to the magtape on unit 1, The /Z options causes BACKDK to zero the magtape before the 


transfer begins, 
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Table 4-17 
BACKUP Options for Privileged Accounts 


Resets date of creation and date of last access information 
to the current system date. 


Causes BACKDK to run detached from the terminal. 


Used with /DET option to broadcast an action message at 
the system console terminal (KB@:) when a continuation reel 
of magtape is required or when any error message fs to be 
printed, 


/Q 
/Q:X 


Specifies that eight 256-word blocks are to be written in (or 
read from) each magtape record. If an integer number 
between I and 16 inclusive is given as the argument x, 
BACKDK uses that number of 256-word disk blocks for each 
magtape record. Without /Q, each magtape record 
contains one 256-word block. 

NOTE 


To avoid errors, files written to magtape 
with the /Q option must be read from 
magtape with the same /Q option. 


Reduces file processor overhead when transferring files 
from a private disk pack or DECpack. The pack must not 
otherwise be accessed while BACKDK is running. 


Since the /Q option is given, BACKDK writes eight 256-word disk blocks per record 
record on the magtape. Each increment of two blocks in the magtape record size causes 
the user job area to increase by 1K words. (To prevent the MAXIMUM CORE EXCEEDED 
error, ensure that a minimum of 12K words is available for the job to run.) The /Q option 
increases the speed of the transfer and decreases the amount of magtape needed to contain the 
files. Any subsequent transfer or verify operation involving magtape requires that the user 


specify the /Q option and the same value of x as originally specified. 
When BACKDK completes the transfer, it chains back to the BACKUP program and enters 


the HB state. The user must attach the job to a terminal to allow BACKUP to print any 


messages or the pound sign character. The listing information is written to the file BACKUP.SYS. 
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4.11 QUE PROGRAM! 


The QUE system program creates requests, or jobs, which are to be executed by spooling 
programs. QUE also executes auxiliary operations such as listing pending requests and killing 
pending requests. The QUE program checks the syntax and validity of each request and passes 
it to another program for further processing if the request is valid. If any part of a request is 
invalid, the program rejects the entire request, prints an appropriate error message, and allows 


the user to fry again. 


For the system fo execute a request created by QUE, the system must contain two other 
programs: a queve manager program (QUEMAN) and a spooling program. QUEMAN 
processes a request created by QUE and places it in the system queue file QUEUE.SYS. The 
particular spooling program executes requests on its related device when the QUEMAN program 
passes it a pending request. Spooling programs on standard RSTS/E systems can be SPOOL, 
BATCH, or RJ2780. If no requests are pending in the queue file, the spooling program executes 
a sleep operation until activated by QUEMAN, 


The file QUEUE.SYS is stored under the system library account on the system disk and 
occupies 262 blocks of storage. The file can accommodate a total of 250 files queued as 
job requests, 


4.11.1] Running QUE at a Terminal 


A privileged or non-privileged user runs QUE at a terminal logged into the RSTS-11 
system by typing the RUN command as follows: 


When QUE runs, if prints a header containing the program name, its version and revision 
numbers, and the system name and version and revision numbers. The program ensures that 
the system queue file exists and is accessible on the system library account. If no errors 
occur, QUE prints a pound sign (#) character which acts as a prompting indicator to signal the 
user that he can type a command, After each command is processed, QUE prints the pound 


sign. 


a : 
This feature is not available prior to Version 5B (RSTS/E) systems 
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If QUE runs and encounters an error when accessing the file $QUEUE.SYS, it prints the 


following message and terminates. 


QUEUE NOT INITIALIZED 
READY 


The system prints READY, To run QUE without an error, the user must have the system manager 


or responsible system programmer run the QUEMAN program and initialize the queue file. 


QUE is terminated by typing E or the CTRL/Z combination in response to the pound sign 


character, as shown below: 


#E 
READY 


Control is returned to the BASIC-PLUS command level, as indicated by the READY message 


being printed. Commands to queue, list, and kill jobs and the related error messages are 


explained in the following sections. A summary of the commands appears in Table 4-18. 


4-74 


Table 4-18 
QUE Program Commands 


Q device:jobname=file spec(s) | Allows user to give a file specification (s) 
of a file to be processed. A comma is used 
to separate file specifications if more than 
one is given, See Table 4-17 for options 
which may be given with a file 
specification. 


: ek oe ul 
L device =jobname(s 


Prints af the terminal a list of the currently 
pending requests for the spooling program. 
If device: is not given, LPO; is assumed. 

If device: is not given and jobname(s) is 
given, the = character is required. Valid 
devices are LP:, LPO:-LP7:,BA:, BAO: 
~BA7:, and RJ:. Specifying LP: or BA: 
indicates all units of that device. If no 
jobname appears, QUE prints all jobs. 


Removes from the queue the job(s) indicated 
by device specification and jobname. If 
device is not given, QUE assumes LPO:. 

If device: is not given and jobname(s) is 
given, the = character is required. 


K device:=jobname(s) 


Causes an information message to be 
printed at the terminal. 


Causes QUE to terminate and to 
return control to BASIC=PLUS command 
level. 


Type the CTRL/Z 


Causes QUE to terminate (same as E). 
combination 
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4.11.2 Using the Q Command 


The Q command typed in response to the pound sign creates a request for a spooling 


program. The Q command has the following general format. 
Q device:jobname=file spec, file spec, ...,file spec 


where: 


device is the device designator LP:, LPO:-LP7:, BA:, BAO:-BA7:, and RJ: 
and unit number of the device which the spooling program services. 
If a designator is not given, LPO: is assumed. If a device is 
specified, the = sign is required. The designations LP: and BA: 
cause the request to be queued for any available spooling program 
for that device type. 


If a unit number is specified, the request is queved for that unit 
and is executed only if a spooling program is running on that 
unit. Additionally, the general batch processor BA: processes 
only those jobs queued for BA: and not jobs queued for BAO: 
through BA7:. BATCH processors BAO: through BA7: however, 
process requests queued for their respective units and requests 
queued for BA:. 


jobname: is a maximum of six alphanumeric characters to identify a user's 
request in the queue. If device and jobname are not specified, the 
= sign is optional and the filename of the first file specified in the 
request is the job name. Several options described in Table 4-19 
may accompany the jobname. 


file spec: is the external file specification of the file to be processed from the 
queue and any combination of Q command options. Up to 14 files 
can be included in a request. File specifications are separated by a 
comma. (See Table 4-20 for the options.) 


The jobname (or the left hand side of the = character) can have several output options 


which apply to the entire request. Each option must be preceded by a slash character (/). 
Table 4-19 lists and describes the output options. 
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Table 4-19 
QUE Job Output Options 


The value n specifies the MODE which the spooling program will 
use in its OPEN statement for the output device. See Section 

3.2 of the RSTS/E Programming Manual for information on the line 
printer MODE values. 


Option Format 


/AFTER:hh:mm The value hh:mm specifies, in hours and minutes, the 24-hour 
(military) time after which the queve manager wil! initiate the 
current request. For example, /AFTER:13:30 causes the job to 


be initiated after 1:30 p.m. 


/PR:n QUE sets the priority to the value n which can be between 0 and 
128. If /PR:n is not specified, QUE assigns the value 128. A 


privileged user can specify a priority between 0 and 255, 


/FORMAT:nn Use the format specified by nn for printing the file. Value may be: 


FO FORTRAN forms control. 
NO Embedded forms control (equivalent to papertape) 
LF Implied forms control (LF and CR printed before 


each record) 


If the input device is not magtape or is DOS/BATCH format magtape, 
the default assumes embedded forms control. If the input device is 
ANSI format magtape, the default is the forms control denoted in 

the magtape label. 


The extemal file specification of a file to be included in the job can have the following 


form: 


device:filename .extension[proj, prog]/option/option... 


A valid device designator is either DKn:, DPn:, MTn:, DTn:, or null (which indicates the 
system device in the public structure). QUE interprets logical names if the user makes the 
assignment before QUE runs. Otherwise, an unassigned logical device name generates the 


ILLEGAL INPUT FILE error. See Section 2.7 for a description of logical names. 


The filename and extension may consist of ? and * characters described in Table 4-15 in 
Section 4,10 of this guide. The [proj, prog] designation is the project-programmer number 
(account) under which the file to be printed is stored. The designation can be omitted if the 
file is stored under the current user's account. The /option designation is a slash character (/) 


followed by one of the Q command options. The options are described in Table 4-20. 
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Table 4-20 
Q Command Options 


Copies Tells SPOOL to print the number of copies indicated 
by the decimal integer n. If /C:n is not given, one 
copy is printed, 


Noheader Tells SPOOL to suppress printing of the file 
header, 


Delete Tells SPOOL to delete the file after it is printed 
if the protection code of the file permits. If /D 
is not specified, the file is left intact. The 
QUEMAN program checks the protection code of 
the file. 


Restart : If a system or device malfunction occurs while SPOOL 
is printing the file, backup n physical disk blocks 
from the point at which printing stopped and continue 
printing. The value n can be a decimal integer 
between 0 and 255. A value of 255 restarts the job 
from the job header page onward. 


Equivalent to /R:255, SPOOL resumes printing from 
the job header page onward, If /R:n is not given, 


SPOOL uses /R:0. 


Used at the end of a command line only to indicate 

to QUE that the user has more text to type on the next 
physical line, If used when chaining to QUE the 
program generates error 12, 


Used to indicate a binary file to the RJ2780 program, 
which must be in TRANSPARENT mode. 


The following command typed to QUE, 


#Q ABC .DAT 

¥ 
causes the file ABC.DAT stored under the current user's account on the public structure to be 
sent to the queue manager for printing on the spooled line printer, unit 0. SPOOL generates 
one copy of the file under the user job header ABC. If printing of the file is interrupted for 
any reason, the program continues printing after the last character printed before the 


interruption. 
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To queue a file from a device other than the public disk, specify the device designator 


in the command. For example, 


#Q DT0:A.BAS/C:2 
# 


The indicated file on DECtape unit 0 is queued for printing on line printer unit 0. The device 
must not be assigned or otherwise in use since the system generates the DEVICE NOT 
AVAILABLE error when SPOOL attempts to access the file. SPOOL generates two copies of 


the file under the job header A. 


To specify a job name for the request, type the name and the = character in the command. 


For example, 
# Q SORT=DK1:FILEA, DK1:FILEB/C:2 


SPOOL prints SORT in the job header and generates one copy of FILEA and two copies of 
FILEB, 


To specify a spooling program other than the one for line printer unit 0, type the 


appropriate designator and the = character in the command. For example: 


# Q LPI :=DTO:FILOUT.001/R:2 
# 


QUE creates a request for FILOUT.001 on line printer unit 1, with job name FILOUT. If 


printing is interrupted, SPOOL backs up two blocks when it resumes printing. 


To specify a request longer than one physical line, type the /MORE option as the 


last item on the line. For example, 


#Q LP] :PRINTI=FILET .001, ABCDEF .001, /MORE 


MORE > HELP .TXT,ACCT SYS 
# 
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As a result, QUE prints, as a prompting indicator, the text MORE>, after which the user 
can continue typing the request. QUE allows up to fourteen files in one request. The user 


can type /MORE as many times as necessary. 


When a device designator is specified in the command, QUE uses that device (and not 
the system device) as a default for subsequent input file names on the physical line. For 


example, when this command is executed: 
#Q LP1T:SORT=DT2:FILEA, FILEB 


QUE sets the device to DT2: for both FILEA and FILEB. Because no device designator is specified 
for FILEB, DT2: becomes the default device. 


To set a priority to a job when queuing a file, the user specifies the /PR:n option with a 
value between 0 and 128. Without the /PR option, QUE assigns a priority of 128 to the job. 
The queue management program processes jobs with a priority of 128 or greater before processing 
jobs less than 128, Only privileged users can specify a priority greater than 128, With such a 
priority scheme, the queue manager can process important jobs before routine jobs and can 


delay processing less important jobs until routine jobs are completed. 
4.11.3 Using the L Command 


The L command lists, at the user's terminal, information concerning pending requests for 


a specified device. For example: 


#L LPI 
TP1 QUEUE LISTING is JAN-75 99:58 AM 
uN JOB P FILES 
~~ ADDRESI120,71] _ ET Ee Ca 8 SY  :ADDRES. [ 120, 71 ] 
—~MASTERI120,71]. © 7 120. SY :MASTER.BAS [120 , 71 | 
REE TS ARES TTT 


The L command causes QUE to print two header lines for the specified spooled device. The 
first header line contains the device and unit designator of the spooled device, the current 
system date, and the time of day. The second header line contains text fo denote the unit 
queued to, the job name and account number of the requester, the status, priority, and full 
file specifications associated with each job. If no device and unit designator appear in the 
L command, QUE prints a listing of line printer unit 0 jobs. If no jobs are queued, QUE 
prints the header lines followed by the # character. Otherwise, jobs are listed in the order 
which QUEMAN accesses them. The status indicates whether the job is waiting to be pro- 
cessed (value @) or is being processed by the spooling program (value of non-zero). To list 
jobs on all line printers, type the L LP: command, QUE prints the related unit number in 
the UNIT column for each queued job. Jobs queued for the BATCH processor are listed by 
typing the L BA: command; jobs queued for the RJ2780 program are listed by typing the L RJ: 


command, 
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To list only information concerned with one request or requests, include the = character 


followed by the jobname(s) in the L command. For example, 


#L LPT:=ADRES 
LP1_ QUEUE LISTING (3-JAN-75 99:59 AM 
UNIT JOB mwa FILES 


“TY ADRES [120,71] 5 7 128 SY :ADRES. [ 126, 71 ] 
o_O EOE 


QUE prints the heading lines and the data for the job name specified. If the user specifies 


more than one jobname, each must be separated by commas. For example, 


#L LP1:=ADRES, MASTER 


LPI QUEUE LISTING @3-JAN-75 10:01 AM 
a JOB S /-k FILES 

MASTER[12@,71] 1 7 128 SY :MASTER.BAS [ 128 , 
ADRES [128,71] 128 SY :ADRES [ 128 , 71 ] 
EL _ 


4.11.4 Using the K Command 


The K command removes a job or jobs from the queue file QUEUE .SYS for a specified 
device. To remove a job, specify the device designator and the = character followed by the 


job name or job names separated by commas. For example, 


#K LP1:=PRINTI, BATCHI 
# 


As a result, each job for the user's account in the LPT: part of the queue with the names 
PRINT! or BATCH] is deleted if it is not currently being processed by the LP1: spooling 
program. If the spooling program is currently processing a file for a job killed by QUE, the 
queue manager program QUEMAN completes that file and subsequently terminates processing 
on the remainder of the job. To immediately kill a job which is currently processing, the user 
must generate an error to interrupt the spooling program (for example, by putting the line 
printer unit off line) and must type an appropriate command to terminate processing by the 


spooling program on that job. Section 5.2 of the RSTS/E System Manager's Guide 
describes the SPOOL commands. 


4-81 


4.11.5 Chaining to QUE from a User Program 


To run the QUE program by a CHAIN operation, the user program must first put in core 


common a string in the following format. 


Program name The filename specification of the program to which QUE passes 
control. The specification can include a project-programmer field but 
not an extension. This program need not be the calling program. 


Delimiter The delimiter must be CHR$(13), the CR character. 


Line number An integer number in CVT%$ format indicating the line number 


of the program to which QUE passes control. For example, 
CVT%$ (28000%). 


Command The string QUE executes, It must have the same syntax as if it were 
typed at the terminal in response to the * character but must not 
include CR and LF characters. The option /MORE must not be used. 


Delimiter The delimiter must be CHR$(13). 


Text Optional string which QUE places in core common when it 
completes processing and passes control. {ts length is restricted 
by the number of bytes remaining in core common, 


Secondly the user program must execute a CHAIN "$QUE" 31000 statement, to actually pass 


control to QUE stored in the system library account. 


Upon completing the request passed to it through core common, QUE places a string in 
core common and executes a CHAIN "program name" line number statement. The program 
name and fine number are taken from the values passed to QUE in core common. The core 


common string QUE passes has the following format. 


Error number The QUE error code in CHR$ format. For example, CHR$ (E%). 
See Section 4.11.6 for a description of the error codes generated 
by QUE. CHR$ (0%) indicates no error code was generated. 


Text The optional string which the user program passes to QUE. 
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4.11.6 Error Messages and Codes 


QUE reports an error condition by printing a message or by returning an error code. When 
running at a terminal, QUE prints a unique message which describes the error condition, No 
part of the command typed is executed, The user must retype the entire command in the 
correct format. Any RSTS-11 system errors encountered are reported in the ILLEGAL INPUT 
FILE message. When running by means of a CHAIN operation from a user program, QUE 
reports an error by an error code when it passes control. Table 4-21 gives both the messages 


and codes and describes the related error conditions. 


Table 4-21 
QUE Error Messages and Codes 


Message Meaning 
None QUE processed command without error. 
INVALID COMMAND-<text> | The<text>indicated is an undefined command. 


SW ON WRONG SIDE The option switch specified in the command 
OF COMMAND line to QUE is reserved for the input 
side and was found on the output side, or 
vice-versa, 


INVALID SWITCH FORMAT The option contains an invalid request. 


UNDEFINED SWITCH The command line contains an undefined 
option switch, 


TOO MANY FILES No more than fourteen files can be given 
in the Q or K command. 


NULL FILE SPEC At least one file specification must be given 
in a Q or K command and none was found; 
or two commas occurred with no file 
specification between them. 


Not used. 


ILLEGAL INPUT FILE - The request is invalid because the file 
<text--file spec> indicated by the file specification caused 
the RSTS error described in the text. The 
user must retype request. 
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Table 4-21 (Cont.) 
QUE Error Messages and Codes 


WILDCARDS NOT ALLOWED An asterisk is not allowed in the 
IN PPN project-programmer field. 


QUEUE FULL The queue file is temporarily full. Try 
again when the spooling program has 


processed some pending requests. 


BAD SWITCH VALUE = text 


QUE encounters an invalid or improper 
number in the option indicated by the 

text. For example, user specifies /MODE:A 
or a non-provileged user specifies /PR:129 

or greater. 


‘MORE! REQUESTED ON A 
CHAIN 


The /MORE option is not allowed when a 
program runs QUE by a CHAIN operation. 


NOT A QUEUABLE 
DEVICE 


The user attempted to queue a request to a de- 

vice which cannot handle queued requests. For 
example, Q LG:=JOB. 
Not used. 


QUEUE NOT INITIALIZED 


The queue file QUEUE.SYS does not exist 
in the system library account. A privileged 
user must run QUEMAN to initialize the 
queue. 


QUEMAN NOT RUNNING - 
CAN'T QUE OR KILL 


User attempts to queve or kill a job and, 
because queue manager is not running on 
the system, QUE generates an error. How- 
ever, user can list jobs without QUEMAN 
running. 
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4.11.7 Running QUE by CCL Commands 


On RSTS/E systems not modified otherwise, a user can run QUE by means of the concise 
command language (CCL) command QUE. The correct format is QUE/ command line where 
command line is any valid QUE program command. If the QUE program does not find a / char- 
acter immediately following the characters QUE, it defaults the command to a Q command, 


For example, 


QUE/Q JOBI = ABC .DAT 
and 


QUE JOBI = ABC .DAT 


The commands are equivalent since both enter JOBI in the queue for line printer 8. In either 
case, the QUE program runs and executes the command. If no error is detected, the system 
prints the READY message. An error in the command causes QUE to print the related error 


message on a subsequent line, after which the system prints READY. 


To include an output option when queuing a job, the user must begin the QUE command 


with /Q or else must give an explicit job name in the QUE command, For examole, 


QUE/Q/MODE:2048=DT@: DISK .BAS 
READY 


The / character preceding the Q character differentiates the Q command from the job name Q, 


To list or kill jobs, the user must type QUE, followed by a slash (/) character and the 


appropriate command. For example, 


QUE/L LP2:=PRINTI 
LP2 QUEUE LISTING 19-JUN-74 4:33 PM 


UNIT JOB S/P FILES 
2  PRINTI[120,80] 1/0 DT@:DISK .BAS[129, 82) 
READY 


QUE runs and executes the command indicated following the / character, after which control 


is returned to BASIC-PLUS command level. 
4.11.8 Running QUE at a Logged Out Terminal 


The currently pending requests for a spooling program can be printed by typing the QUE/L 


dev: command. For example, to print the line printer unit 1 queue, type the following command, 


QUE /L LPI: 
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QUE executes the L (LIST) command for the LP1: queue. After printing the pending requests, 
QUE exits to RSTS/E and prints BYE. 
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4,12 BATCH PROCESSING: 


The capability to execute a batch of commands allows the user to submit jobs to be run 
without terminal dialogue. Batch processing is particularly useful in executing large data 


processing operations for which interactive requirements are not a factor. 


w 
Qa 
> 
a 
= 
~e 


nput can be submitted from standard files on a random access device. 


card represents one record. Such input consists of elements of the batch control language and 
is collectively referred to as a batch stream. _It is possible to execute multiple streams 
simultaneously by running multiple copies of the BATCH program. The capability to run 


more than a single batch stream is controlled by the system manager. 


Sections 4.12.1 through 4.12.3 discuss the elements of the batch control language. 


Operating procedures are described in Section 4.12.4. 
4.12.1 Control Statements 


Batch control language statements consist of a command field, specification field(s) and 


a comment field, in the following format: 
$<command-field> [specification-field(s)] [lcomment] 
Fields must be separated by one or more spaces and/or tabs. 


A command field must always be present and may contain switch modifiers to control or 
limit the command, When appropriate, the command field is followed by one or more specifica- 
tion fields, The ! character is a comment prefix signifying that the information between the | 
character and the line terminating character consists of comment information. The system 


takes no action on comment information. 


The dash (-) character can indicate a continuation of a command. If a dash is the last 
character in a command, the next line is treated as a continuation of the previous line and 


must begin with a $ followed by a blank, 


’ This feature is not available prior to Version 5B (RSTS/E) systems, 
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Double quote characters may be used in control statements to reproduce some text identically 
and override any special interpretation of characters by BATCH. For example, the exclamation 
point (1) in RSTS/E is the designator for the auxiliary library account [1,3] or for an installation 
defined account. In BATCH, the exclamation point signifies a comment. To prevent BATCH 
from misinterpreting the | character given as an account designator, use quote characters as 


shown in the following sample contro! statement. 
$RUN “!UPDAT" 


As a result, BATCH executes the program UPDAT from the auxiliary library account. Without 
the quotes in the above example, the current program is executed and the characters following 


the | character are treated as comment characters. 


4,12.1.1 Command Field - The command field comprises the following elements: 


1. A$ (dollar sign) character is the first character position. 
The $ character is the control statement recognition character. 


2. The command name begins in the second character position and 
immediately follows the $ character. For example, $JOB. No blanks 
are allowed in the command field because a blank (or horizontal tab) 
delimits the command field. 


3. Valid switches. No blank can appear between the command name and 
a switch. Switches are denoted by a / character. For example, /NAME=COMPL. 


NOTE 


Command names and switch names can be shortened 
to their first three characters, For example, the 
system interprets the command BAS as well as BASIC, 
Any other form, such as BASI, is invalid. 


Multiple, adjacent blank characters are equivalent 
to one blank character. A horizontal tab is 
equivalent to one blank character, A blank 
character delimits the command field; otherwise 
the blank character is ignored. 


4,12.1.2 Specification Fields - A list of specification fields immediately follows the command 
field delimiter. The following rules apply: 


1. Specification fields are separated by blanks, 


2. Specification fields are terminated by a ! character if followed by a comment, 
or are otherwise terminated by a line terminating character. 
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3. 


Depending on the command, a specification field consists of a device specification, 
a file specification, or an arbitrary ASCII string, any of which can be followed 

by appropriate switches. The / character signals the start of a switch, For 
example, XYZ.BAS/SOURCE. The switch indicates that the file is a source file. 


4.12.1.3 Comments - The following rules govern comment fields. 


1. 
2 


The start of a comment is defined by an ! character in the control statement. 


Any character following an ! character and preceding the end=of-line terminator 

is treated as a comment and is otherwise ignored by the batch processor, Comment 
lines with no text may force line spacing on the job log and thereby make the log more 
readable. To force line spacing, simply include lines consisting solely of $! 

followed immediately by a carriage return/line feed, 


4.12.1.4 Syntactical Rules - The following are syntax rules for control language statements. 


1. 


A control statement must have a command name (except in the case of the comment 
line "$1"). If the command name is omitted, the command is ignored. An 
unrecognizable command name is illegal. An appropriate error message is printed 
by the batch processor, Only two forms of the command are recognized: the 

full name and the 3-character abbreviation of the name, For example, the 
following are the legal BASIC-PLUS commands: 


$BASIC $BAS 


Switches in the command field apply to the entire command. If a switch 
appears in the specification field which contradicts a command field switch, 
an error results. 


An asterisk is allowed in the filename or the file type field of a file specification, 
See Section 4.12.2 for the description of file specifications, An asterisk can 
refer only to files already created, An asterisk appearing in a file specification 
used in file creation constitutes an invalid file specification. 


The batch processor uses the leftmost 6 characters from file name fields longer than 
6 characters and uses the leftmost 3 characters from the file type fields longer than 
3 characters. 


An invalid filename field, file type field, device specification, or project- 
programmer field in a file specification causes the control statement in which it 
appears to be invalid. The batch processor does not execute an invalid control 
statement, An error message is printed, 


Switches can be used in the command field and specification fields of a control 
statement. Switches appearing in the command field are command qualifiers, 
and their function applies to the entire command, Switches appearing in 
specification fields apply only to the field in which they appear. 


Unrecognizable switches invalidate the control statements in which they appear. 
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4.12.1.5 Syntax Example - The following are sample control statements which illustrate 
the syntax of Batch statements. 

$JOB/NAME=SMYTHE IFIRST JOB 

$ COMPILATION OF NEW SOURCE FILES 

EMESSAGE STARTING COMPILATIONS 

$BASIC XYZ/SOURCE XYZ.LIS/LIST XYZ/OBJECT 

$BASIC ABC/SOURCE ABC.LIS/LIST ABC/OBJECT 

SMESSAGE STARTING LISTING OUTPUT 
Sent * LIS! ALL LIST FILES 


$ 
$EOJ 


4,12.2 File Specifications 


A file specification appears in the specification field and is an alphanumeric string 


containing the following elements: 
filename .type 


The batch processor assigns default values if part of the file specification or all of it is 


optionally omitted. 


4.12.2.1 Filename Specification - A filename specification is a string of alphanumeric 
characters of which the first six characters must be unique. An asterisk in the filename field 
denotes all files of the specified type in the account designated. If necessary, the batch 


processor generates a default filename related to the time of day as described in Section 
4.12.2 aos 


4.12.2.2 File Type Specification - A file type specification consists of a period, immediately 
followed by a string containing three or more alphanumeric characters, the first three of which 


must be unique. 
The file type reflects the type of the file. For example, a BASIC source file has .BAS 


as its file type. An asterisk in the file type field denotes all file types including files with 
no type specified. 


4-90 


Standard file types are listed below. 


CTL Batch control file 

-DAT Data file 

-DIR Directory file 

-BAS BASIC source file 

«LIS List file 

«BAC BASIC compiled output file 

-CBL COBOL source file 

-OBJ COBOL compiled output file 

SRT PDP-11 SORTI1 input, output or listing file 


These file types are the defaults when no file type is specified. The default chosen is 
determined by the current operation and by the type of file expected. Table 4-22 summarizes 


the default file types that apply to particular batch commands. 


Table 4-22 
Batch Commands ~ Related Default File Types 


Command/ 
Section 


$BASIC : Input source file default type. 
4.12.3.3 
Output object file default type. 
Listing file default type. 


$CREATE : The file generated as output by CREATE has a file 
4.12.3.4 type of .DAT. 


$DIRECTORY F The file in which the directory is to be recorded has 
4.12.3.4 a file type of .DIR. 


$JOB . Batch control file default type; assumed when the 
4.12.3, Batch job is on a file-structured device. 


Batch output log file default type. 


$PRINT Default type of file to be printed, 
4.12,3.4 


$RUN ? Default type of file to be run. 
4.12.3.5 
$COBOL! : Input source file default type. 
4.12.3.11 : ‘i 

Output object file default type. 


Listing file default type. 


$SORT! : Input, output or listing files default type. 
4.12.3,12 


"This feature is not available before Version 6A systems. 
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4.12.2.3 File Specification Defaults - Defaults are assigned to omitted filename and file 


type elements as shown in Table 4-23. 
Table 4-23 


File Specification Defaults 


Cn 


Name specified but no ABC=ABC . type 
file type 


Default assigned as appropriate 

to the current operation. For 
example, with the BATCH command 
BASIC, the default is .BAS. 


Name, followed by dot, ABC .=ABC 


but no file type 


Default file type is null. 
No file type is assigned. 


Default filename is related 
to time of day. 


~LIS=B2347P .LIS 
(created at 
91:23:47 PM) 


File type, but no name 


Default filename (related Null=B2347P .type 
to time of day) with default 
type as appropriate to 


current operation. 


No file specification 


4.12.2.4 Switch Specification - Switches consist of a/ character followed immediately by a 


name. If the switch takes an argument, the argument is separated from the switch name by a 
colon (:) or equal sign ©). If the switch takes an argument and subarguments, each sub~ 


argument is separated from the argument and themselves by a colon. For example, 


/NAME=JOB3 
/VID="MY TAPE" 


Switches accept arguments of standard types, such as decimal constant, alphanumeric string, 


and date-time. 


Switch values can be negated by putting the characters NO between the / character 


and the switch name. For example, 


/NOOBJ 


This switch indicates that no object file is to be produced. It would be used in conjunction 


with the $BASIC and $COBOL commands, usually. 
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NOTE 


The negation characters NO are not 
considered part of the switch name. 
Thus, a negated switch must contain 
at least five characters. For example: 


/NOOBJ or /NOOBJECT 
is valid, but 
/NOO 


is invalid. 
4.12.3 BATCH Commands 


The BATCH command set consists of 


$JOB ~ begins a job 

$EOS ~ ends a job 

$BASIC - executes BASIC-PLUS compiler 
sutility - executes system utility function 
$RUN - executes program 

$DATA - begins data images 

$EOD - ends data images 

$MESSAGE - logs message on control terminal 
$MOUNT ~ assigns device 

$DISMOUNT - deassigns device 

$COBOL! - executes the COBOL compiler 
$sort! - executes the PDP-11 Sort program SORT11 


4,12.3.1 $JOB - This command marks the beginning of a job. The following command 


switches are allowed. 


/NAME=jobname This switch assigns a name to the job. Job names can be up to 
I I 
6 characters long. This name overrides the control file name as 
the identifier of the job. 


/NONAME This switch indicates that no job name is defined. A default 
job name is assigned. The default job name is the name of the 
control file. The name appears in all messages to the system 


operator. 


/UMIT=nnn This switch is used to assign an elapsed time limit to the job. 
The value of nnn, a decimal number, is interpreted as minutes. 


‘This feature is not available before Version 6A systems. 
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/NOLIMIT! Gives the job an unlimited amount of elapsed time to complete. If 
neither /LIMIT:nn nor /NOLIMIT appear, the job is given 19 
minutes elapsed time to complete execution before BATCH terminates 
it. 


/PRIORITY :n2 Sets the RSTS/E job priority to n (or the nearest multiple of 8) for 
the BATCH stream. For privileged users, n can be between -127 
and +127; for non-privileged users, n is limited to a value between 
-127 and -8. Unless otherwise altered by the /PRIORITY:n switch, 
all jobs run at -8 priority. 


/CCL This switch allows the use of the system's interactive Concise 
Command Language. When this switch is specified, any of the 
system commands which do not conflict with existing Batch 
commands may follow the $ character. The batch processor insures 
that the job is in the READY state before executing the command. 


The following specification field may be included: 


[n,m] To have the job executed on an account other than that under 
which it was queved, a specification field may indicate the 
account number desired. This can only be used by a privileged 
user. 


The following are the error conditions possible. 


Unrecognized switch 

Ilegal switch value 

Multiple conflicting specifications (switches) 
Different account specified by non-privileged user. 


4.12.3.2 $EOJ - This command marks the end of a job. The $EOJ command automatically 
dismounts all devices mounted by the job. $EOJ prints an appropriate message to the operator 


that the logical device should be dismounted. A logical deassignment is performed. 


NOTE 


a. A $EOJ is implied when a physical end 
of file condition or a $JOB control state- 
ment is encountered while processing a 
job file. 


b. No switches are legal on the $EOJ 
command, 


The following are the error conditions possible. 


Non-comment characters following $EOJ, 


lon systems before Version 6A, the /NOLIMIT switch set the time limit to 10 minutes. 


This feature is not available before Version 6A systems. 


4,12.3.3 $BASIC - The $BASIC command calls the BASIC-PLUS compiler, which compiles 
the source program into an object program. The format of the $BASIC command is: 


$BASIC[switches] [specification fields [switches] 


The following command field switches are valid. 


/RUN Compile and execute the program. 

/NORUN Compile only. If no switch is specified, only compilation occurs. 

/OBJECT Produce a compiled file. 

/NOOBJECT Do not produce compiled file. If no switch is specified, a 
compiled file is not produced. 

/LIST Produce a listing file. 

/NOLIST Do not produce a listing file. If no switch is specified, a 


listing file is not produced, 


As indicated, the specification field is optional. Up to three file specifications can 


appear: source, compiled, and listing. These are indicated by specifying the appropriate 


switch: 
/BASIC 
or indicates input source file 
/SOURCE 
/OBJECT indicates output compiled file 
/LIST indicates output list file 


If a source file is not specified, the $BASIC command must be followed by a set of BASIC-PLUS 
source statements, terminated by either $EOD (see Section 4.12.3.7) or some other recognized 


batch control statement. For example, 


$BAS LISTING/LIS 
BASIC=PLUS 


Source 
Deck 


$EOD 


If a source file is explicitly specified, any source statements following this command are appended 
to the source program. Source statements following this command and having line numbers 
equal to those in the source program replace those in the source program. Source input must be 


provided, either through a file specification, or through source statements, or both, 
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If no listing file is specified, but the /LIST switch is present, the Batch processor creates, 
prints, and subsequently deletes the default listing file. If a file specification appears with 
the /LIST switch, the batch processor does not automatically queve the file for printing. To 
print the file specified as part of the batch job, the user must supply a $PRINT control statement 
described in Section 4.12.3.4. 


If no object file is specified with the /OBJECT switch, a default object file is created 
and is deleted after job completion. !f an object file is explicitly specified, it is preserved 
after job execution. Errors result from conflicting switch specifications such as both /BASIC 
and /SOURCE on different specification fields. 

The default applied when a file is specified without a switch is /SOURCE. 

The following are the error conditions possible. 

Unrecognized switch 
Multiple conflicting specifications (switches) 
File specification syntax error 


4.12.3.4 Utility BATCH Commands 


The following utility functions are provided by the RSTS/E batch processor. 


$DELETE - deletes files 

$COPY - copies files 

$PRINT - prints a file on the system line printer by means of the 
line printer spooling program SPOOL. 

$DIRECTORY - lists a file directory 

$CREATE - creates a file from data in the input stream 


$DELETE 


The $DELETE command is used to delete specified files. It is specified in the following 


format. 


$DELETE file! [file2 ... filen ] 
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The filename and file type must be included. An asterisk is not valid in either the filename 


or the file type field. 
No switches are used with $DELETE, 
The following are the error conditions possible. 


No file specification 


Syntax error in file specification 
$COPY 


$COPY is used to copy files, Use of the asterisk character in the filename and extension 


specification is invalid, The following are the valid switches. 


/OUTPUT for new files to be created 
/\NPUT for files to be copied 


The following is an example of the $COPY command. 


$COPY TER .LIS/OUTPUT TERRY .LIS/INPUT 


The $COPY command supports the use of + (plus sign) to indicate file concatenation, When 
used with $COPY, file concatenation results in the creation of a single file, consisting of files 
connected together. The + character appears in the file specification field, between the 


specifications of files to be concatenated. If no switch is specified, /INPUT is assumed. 


The following are the error conditions possible. 
No output specification 
No input specification 
Multiple conflicting specifications 


Syntax error in file description 


4-97 


SPRINT 


The $PRINT command prints the contents of files on the system line printer by means of the 
spooling program SPOOL. No switches are valid. Asterisks in file specifications can be used. 


The $PRINT command is formatted as follows. 
$PRINT filel [ file2 ... filen] 
where the specification field contains the file or files to be printed. 
The following are the error conditions possible. 


No file specification 


Syntax error in file specification 
$DIRECTORY 


$DIRECTORY produces a directory listing of the file(s) in the specified account and has the 


following format: 
$DIRECTORY [specification field] 


The specification field can contain file specifications. If no file specification appears, 
the $DIR command lists the contents of the current account on the batch log device. A file 
specification indicates the directory of a file or set of files and can contain an asterisk in either 


the filename field or file type field. For example, 
$DIR * BAS 


The statement creates a directory listing of all files in the current account with the .BAS 


extension. 


To create a directory in a disk file rather than on the batch log device, the user can 


specify a file and the /DIRECTORY switch. For example, 


$DIR BAJOB.DIR/DIR 


creates the directory listing in a file BAJOB.DIR on the system disk under the current account. 
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To create a directory in a disk file and to designate which files are to be listed, the user 
must specify both the /DIRECTORY and /INPUT switches with the related file specification, 


For example, 
$DIR BA.DIR/DIR * BAC/INPUT 


The $DIR command shown subsequently creates a directory listing of all compiled BASIC-PLUS 
files and stores the listing in the file BA.DIR on the system disk under the current account. 


& error Conatiions are: 


Syntax error in file specification 


Multiple conflicting specifications. 


$CREATE 

The $CREATE command creates a file as indicated in the specification field. The file 
consists of the data images following the $CREATE command in the input stream. Data images 
must follow $CREATE and must be terminated by $EOD, or an error occurs. The data images 
must not be preceded by any other command because the $CREATE function terminates on 


encountering a $ in the first column of a data image. 


Any previously existing file of the name specified is deleted at batch execution time, and 


replaced by the file created by the $CREATE command. 
The $CREATE command has the following format. 
$CREATE file 
The following are possible error conditions. 
Syntax error in file specification 


No file name specified 


Non-comment characters following file specification 
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4.12.35 $RUN - The $RUN command causes execution of system programs. For example, to 


run PIP, specify 
$RUN $PIP 


followed by appropriate PIP commands. The PIP program reads the commands as data images in 


the input stream. Execution of PIP is terminated when the next batch control statement is read. 
No switches can be specified. The general format of $RUN is: 
$RUN [file] 


where file specifies the executable program. If file is omitted, the default current program is 


used. 
The following are the possible error conditions. 


Syntax error in file specification 


Non-comment characters following file specification 
4.12.3.6 $DATA - The $DATA command permits the user to include source data in the input 
stream following a $BASIC command (with the /RUNswitch) without specifying a filename for 
the source data, The $DATA command is specified in the following manner. 


$DATA 


No specification field or switches are recognized. If no data records follow $DATA, a zero- 


length file is implied . 
Possible error conditions are the following: 
Non-comment characters between $DATA and the line terminator. 


4.12.3.7 $EOD - $EOD marks the end of data records included in the input stream 
following commands such as $BASIC, $CREATE, $DATA, and $RUN. For example, 
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$EOD 


4.12.3.8 $MESSAGE = This command logs a message on the system control terminal. It 
provides a way for the job to communicate with the operator. The command has the following 


format. 
$MESSAGE[/WAIT] message-string 


The WAIT switch can be used in the command field to indicate a pause to wait for operator 


action. The system pauses until the operator gives the appropriate command. For example, 
$MESSAGE/WAIT MOUNT SCRATCH TAPE ON DTZ 


The operator then mounts the tape and responds with CO to continue batch processing. If 
the operator finds it necessary to kill the job or to defer it for later execution, he does so by 


typing one of the following responses: 
RE - restart 
KI - kill 


DE «defer 


RE results in the log message JOB RESTARTED BY OPERATOR and the job starts over again 
from the beginning of the Batch control file(s). 


KI prints the message JOB KILLED BY OPERATOR on the log and terminates the fob. 
DE causes the message JOB DEFERRED BY OPERATOR and places the job at the end of the 


Batch queve. An invalid response results in a second request for a valid response from 


the operator. 
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4.12.3.9 $MOUNT - The $MOUNT command causes a mount message to be printed on the 
control console, and effects a logical to physical device assignment. The physical device 
refers to a physical device type. The operator responds with the drive number, An automatic 
WAIT occurs. Logical device names of up to six characters are used to specify logical 


devices, 
The $MOUNT command is specified in the following format. 
$MOUNT devn:[/switch] devm: [/switch] 
Both the logical device and the physical device must be specified. The colon is required 


as the terminator for each device specification. The following switches can be used for the 


physical device. 


/PHYSICAL identifies the device specification to be the physical 
device (default) 

/WRITE tells the operator to write-enable the device (or volume) 

/NOWRITE tells the operator to write-protect the volume (default) 


(not permissable for RSTS/E disks.) 


/VID identifies the volume for the operator 
The following switch is used with the logical device: 


/LOGICAL identifies the device specification to be the logical 
device name. 


The /VID switch on the physical device field is used to specify the volume identification. 
The value associated with /VID is the name physically attached to the volume. It is included 


to help the operator locate the volume, 


The string specified for /VID can be delimited by quotes, if the name must contain blanks. 


For example, 
/NAD="FJM JT" 
No blanks are allowed in a string not delimited by quotes. For example, 


$MOU M7:/PHY/VID="MY TAPE" TAPE:/LOG 
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In this example, logical device name TAPE is assigned to a 7-track magnetic tape unit. The 
operator is told that the reel of tape to be physically mounted is labeled MY TAPE. He then 
responds with the physical unit number on which the tape is mounted. Thereafter, in the 
batch command file, reference to the device TAPE: accesses the physical device on which the 
operator mounted the reel MY TAPE. If the physical device is a removable disk pack or 
cartridge, the logical device name must be the pack identification. The batch processor 


logically mounts and unlocks private disks which the operator mounts as a result of $MOUNT. 


The valid physical devices that can be requested for mounting are: 


CR: Card Reader 

DK: Disk Cartridge 

DP: RPII-C/RPO3 or RPO2 disk pack 
DB: RHH/RPO04 disk pack 

DX: RXO1 floppy disk 

DT: DECtape 

LL: Line printer with lower case 

LP: Line printer 

LU: Line printer with Upper case only 
M7: 7-track Magtape 

M9: 9=-track Magtape 

MT: Magtape 

PP: Paper tape punch 

PR: Paper tape reader 

PS: Public Storage (equivalent to SY:) 
SY: System device 

TT: Teletype (or terminal) 


The following are possible error conditions . 


Syntax error in device specification fields 
Invalid device name/unit 

Invalid logical device name specifications. 
Unit number already assigned 


4.12.3.10 $DISMOUNT 


The $DISMOUNT command causes the logical to physical device assignment effected by 
the $MOUNT command to be nullified. It also prints an operator message, requesting that 
the volume be dismounted. If a (WAIT switch is included in the command field, the job 
will not resume until a response, as with the MESSAGE command, is received from the 


operator. For example, 


$DIS/WAI TAPE: 
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The following are possible error conditions. 


Syntax error in specification field 
Illegal switches 


Logical device not assigned 


4.12.3.11 $COBOL! - The $COBOL command calls the COBOL compiler which compiles 
the source program and generates an object program. The format of the command is as 


follows. 
$COBOL{switches] [specification fields [switches]] 


The following command field switches are valid. 


/RUN Execute the previously compiled object file. Only an object 
file can be specified. 

/NORUN Compile the source program but do not execute the object. 
If /NORUN is omitted, the source program is compiled and 
executed. 

/OBJECT Produce a compiled file. If neither OBJECT nor /NOOBJECT 
appears, /OBJECT is used. 

/NOOBJECT Do not produce an object file. If neither /OBJECT nor 
/NOOBJECT appears, /OBJECT is used. 

/LIST Produce a listing file. If neither /LIST nor /NOLIST appears, 
/LIST is used. 

/NOLIST Do not produce a listing file. If neither /LIST nor /NOLIST 
appears, /LIST is used. 

/MAP Include the DATA division map in the listing file. 

/LOD Create the file nnnnnn.MAP (where nnnnnn is the source file 
name) to contain the program load map. 

/CVF Source code is in conventional format. 

/ACC:n Accept errors in the source code of severity n or less. 

/ERR:n Suppress the printing of diagnostic messages if error severity 
is less than n. 

/USW:n:n oe6 Set run time user switches for the compiler. Switch values must 
be separated by colons. The range of values is 1 through 16. 

/HELP Print a help message in the log. No other switches and no file 


specifications are permitted with the /HELP switch. 


'this feature is not available prior to Version 6A (RSTS/E) systems. 
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If neither /RUN nor /NORUN appears in the command field, COBOL automatically compiles 
the source program and executes the object program. If either a source file or a listing file or 
both are specified with /RUN, a conflict occurs. The /RUN switch indicates that an object 
file is to be executed, Source and listing files are specified only when a compilation is per- 
formed. BATCH does not report the file specification (s) as errors but does not pass them to the 


COBOL compiler for processing. 


A maximum of 3 file specifications can appear in the specification field. Each specifica~ 


tion can be differentiated by one of the following switches. 


/COBOL or Indicates input source file. If specification has no switch, 
/SOURCE /COBOL is used for that file. 

/OBJECT Indicates output (compiled) file. 

/LIST Indicates output listing file. 


If /OBJECT does not appear in the specification field, BATCH creates a default object 
file and deletes it after the program run is completed. If a listing file does not appear in the 
specification field, but the /LIST switch is included, a default listing file is created, printed, 
and deleted. Explicitly specified output files (both object and listing) survive the execution 
of the batch job that created them, If a listing file appears in the specification field, BATCH 
creates the listing file but does not automatically queue it for printing. To print the listing 
file as part of the BATCH run, a $PRINT control statement must be supplied. (Section 4.12.3.4 
describes $PRINT.) 


If a file specification appears without a switch, BATCH uses the /COBOL switch for that 


file, 


If a source input file specification does not appear in the $COBOL control statement, 
source statements must immediately follow and must be terminated by either an $EOD statement 


or some other BATCH control statement. For example, 
$COBOL/MAP/LOD COB.LST/LIS 
COBOL 
Source 
Deck 
$EOD 
Because the command field contains neither RUN nor /NORUN, BATCH assumes a compil- 


ation and execution is to be done. A source file is not specified and the data following the 


$COBOL command is compiled. 
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The following command and text describe the defaults used in the $COBOL command. 


$COBOL FILE 


A compilation and execution is done. Because the specification FILE contains no switch, 
/COBOL is used. The default type CBL is used. The source program FILE .CBL is compiled 
and a default object file is created and executed. The object file is automatically deleted 
before the next command is executed with one exception. If the next command is $DATA, 
the object file is deleted after the end of data and before the command following the data. 
A default listing file is created and automatically queued for printing. The listing file is 


deleted after it is printed. 
The following are the error conditions possible. 


Unrecognized switch 

Multiple conflicting switches 

File specification syntax error 

No source input (neither file nor source statements) 


4.12.3.12 $SORT!- The $SORT control statement runs the PDP-11 Sort program SORTI1 (not 
the RSTS-11 program SORT .BAC). The SORTI1 program is on RSTS/E systems with the COBOL 
compiler. For more information on the PDP-11 program SORTI1, refer to the PDP-11 SORT 


Reference Manual. 
The format of the $SORT control statement is as follows. 
$SORT[switches] [file specification[switches]] 


The following are the valid switches for the command field. 


/SIZE:n maximum record size in bytes. Can be between | and 16383, 
/FILES:n number of scratch files to be used. Can be between 3 and 10, 
/PROCESS:x use the sort process given by x. Values can be R (record sort), 


T (tag sort), A (ADDROUT sort), or | (index sort). If 
/PROCESS:x does not appear or if :x is omitted from the 
/PROCESS:x switch, a record sort is performed. 


this feature is not available prior to Version 6A (RSTS/E) systems. 
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/KEYS:abm .n use the sorting key field defined by entries for a, b, m andn, 
Maximum of 10 keys can be specified if each is separated by a 
colon as follows. 


/KEYS:abm.n:abm.n: ... abm.n:abm.n 


/RIN specifies the input file as a COBOL relative file. Without 
/RIN, input file is assumed to be a sequential ASCII file. 
/ROUT specifies the output file as a COBOL relative file. Without 


/ROUT, the output file is created as a sequential ASCII file. 


The command field of the $SORT control statement must have the /SIZE:n switch to define 
the record size. The requirements for other command field switches depend on file specifica- 


tions present and the type of sort requested. 


A maximum of three file specifications can appear in the $SORT control statement: an 
input file, an output file, and a specification file. To distinguish these files, the following 


switches are used. 


/\NPUT the file to be sorted 

/OUTPUT the file to contain the sorted data 

/SPECIFICATION the file which contains the control information for the sorting 
process. 


A file specification without a switch is used as the file to be sorted. If the /SPECIFICATION 
switch is used, the /KEYS and /PROCESS switches must not appear in the command field. Ifa 
specification file is not given in the control statement, the /KEYS switch must be included in 


the command field to control the sorting process. 


Missing elements in a file specification are replaced by BATCH default elements. If type 


is omitted from the file specification, BATCH uses SRT as the type. 
The following is a sample batch stream using $SORT commands. 


$JOB/NAME=SRT0@2/LIMIT=30 
$SORT/PRO:T/SIZ:188/KEY:04.1:01.1 F1@8.188 A/OUT 
$SORT/PRO:T/RIN/KEY:1 .4/SIZ:1 88 R200.100/INP B/OUT 
$SORT/SIZ:108/ROU/KEY:1 .4/PRO:T F10@.108/INP X/OUT 
$SORT/SIZ:60/KEY:3.5/FIL:3 V1Q0.068/INP C/OUT 
$SORT/SIZ:108/RIN R208.186/INP D/OUT SPEC .0@1/SPE 


The /SIZE switch appears in each command to define the record size in the file to be sorted. 
In the first $SORT control statement, file F1Q@.1Q0 is used as the input file. In the second 
statement, the /RIN switch in the command field denotes the input file R200.100 as a COBOL 
relative file. In the third statement, the /ROUT switch causes the output file X.SRT to be a 
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COBOL relative file. For the fourth $SORT control statement, a record sort is performed on 
file V100.@68 because the /PROCESS:x switch is absent. For the fifth $SORT statement, the 
sorting process is controlled by data in the specification file SPEC.Q@1. The /PROCESS:x and 
/KEYS switches are not permitted. For all files without a type in the specification, BATCH 
uses the default SRT. 
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4.12.4 Batch Operating Procedures 


This section describes how the RSTS/E system user requests batch processing and how the 


batch processor generates output. 


4.12.4.1 Requesting a Batch Job Run = To request the running of a batch job, the user runs 


the library program QUE and specifies the batch control file or files as follows. 


RUN $G@UF 


QUE V@6H-G2 - RSTS V@6A-G1 SYSTEM #664 
#0 BA: BATJOB=FILE2, FILE?, FILES. DAT 
# 


The user normally queues a batch job to device BA:. The job and log files in this example 
will be named BATJOB, and the files FILEIT.CTL, FILE2.CTL, and FILE3.DAT will be con- 
catenated to form the batch control file. The log file BATJOB.LOG will be printed after 


the job is complete. 


4.12.4.2 Batch Processing - As the batch control file is read, it is checked for command 
sequence and syntactical validity. If an error is detected, an error message is printed in the log 
file. The job will not be run, but syntax checking will continue through the remainder of 


the file. 


If no errors are detected, the job is processed. A log is printed, showing the sequence 
of Batch commands processed during the course of the job. If program output is directed to 
KB:, this output appears following the command that caused the program to execute. In the 
example that follows, a BATCH job named JOBI has been run. The Batch control file 


contained the following sequence of commands: 


$JOB/NAME=JOBI1/LIMIT=4 
$CREATE SUBI .BAS 


source statements 


$EOD 
$BASIC/RUN LISTING/LIS MAIN/OBJ 


source statements 


$DATA 

data 
$PRINT SUBI .BAS 
$EOJ 
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These commands have the following effect: 


$JOB/NAME=JOBI1/LIMIT=4 


A job name of JOBI is assigned to the job. This name appears on the job log along with 
the time and date of the job's execution. A time Jimit of four minutes is set. If the job is 
not finished in four minutes from its start (actual elapsed time), the job is terminated, and the 


appropriate error message is printed in the log. 


$CREATE SUBI .BAS 


A BASIC source file named SUB] is created, from data records which must follow the 


$CREATE command, 
$EOD 
The $EOD command signals the end of SUBI.BAS. 


$BASIC/RUN LISTING/LIS MAIN/OBJ 


The source file following this command is compiled; a listing of the source statements is 


created in a file named LISTIN.LIS; and the resulting object file (MAIN .BAC) is saved and is 


executed. 


$DATA 


The data to be read during execution of MAIN .BAC follows this command. 


$PRINT SUBI BAS 


The source file created by $CREATE SUBI .BAS is printed. This command also has the effect 
of terminating data input to MAIN.BAC. 


$EOJ 


This command signals the end of job JOBI. 
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4.12.4.3 Error Procedures - When an error is detected in a batch command, the job is not 
started. Instead, an error log is printed listing all commands and data scanned along with the 
appropriate error message(s). The batch log file always indicates all command lines scanned. 


If an error is identified on a command line, the error message follows the command, marked with 
not be executed. 


If no errors occur, the time of output of lines will be indicated in the left margin of the log. 


All normal terminal interaction corresponding to the Batch commands will appear in the log. 
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4.13 DIRECT PROGRAM ~ DIRECTORY LISTINGS! 


The DIRECT program lists file related information from a disk directory. The benefits of 
DIRECT are increased speed and more options compared with other methods of listing director- 
ies. DIRECT opens a user's directory as a file and reads information by immediately accessing 
the blocks in the directory. This action is faster than the conventional method of passing the 
request for such information to certain system functions. Since the program follows linked 


pointers through a disk directory, the pointers must not be changed during program execution. 


The user runs DIRECT by typing the RUN $DIRECT command or by using the CCL command 
explained at the beginning of this chapter. When DIRECT runs as a result of the RUN com- 
mand, it prints the # character which acts as a prompt indicator. The user can then type a 
command to DIRECT. If the user runs DIRECT by the CCL command, he includes the command 
to DIRECT in the CCL command, 


The general format of the command is as follows: 
output=input/option(s) input/option(),... 


Output is optional and can be a device specification or a disk file specification. If output 

is not given, the = character is optional and DIRECT prints output at the user's terminal. 

If an extension does not appear with an output filename, DIRECT appends .DIR unless the 
user forces a null extension by specifying the . character with the filename. Input can be 
any number of full disk file specifications. The full disk file specification on input can 
include a device, filename, extension and project-programmer number. If a device is not 
given, DIRECT uses the public structure and denotes this by the SY: specification. The 
filename, extension, and project-programmer fields can contain * and ? characters to denote 
wild card specifications. If no file specification is given or if an * character is given as the 
file specification, DIRECT processes all files in the directory. DIRECT applies the default 


interpretations shown for the following specifications for a given directory. 


null bier All files 

. ae ® All files 

*, ee All files with null extensions 
‘ = All files with null extensions 
«EXT * EXT All files with extension EXT 
FILE FILE.* All files with filename FILE 


This feature is not available before Version 5 (RSTS/E) systems, 
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With a file specification, the user can specify a /character followed by one or more 
options. If no options appear, DIRECT proceeds as if the user had specified /DI. Table 4-24 


lists and describes the options. 


Table 4-24 
DIRECT Options 


Individual 


List filenames only. 


List filenames and extensions of each file. 


List filename, extension and list size of each 
file as number of 256 word blocks occupied. 


List filename, extension and file protection 
code. 


List filename, extension and date of last 
access for each file. 


List filename, extension and date of creation 
for the file. 


List filename, extension, date and time of 
day when file was created. 


List filename, extension, and file cluster size. 


List only summary data to include number of 
designated files and number of blocks occupied 
by designated files. 


List filenames and extensions with a brief 
summary message. 


Aggregate 


List all relevant data to include headings, 
filenames, extensions, size, protection code, 
date of last access, date of creation, time of 
creation, clustersize and summary. (Called 

slow directory.) 


List most important data to include heading, 
filename, extension, size protection code, 
date of last access and summary. 
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Table 4-24 (Cont.) 
DIRECT Options 


Print heading at top of columns on the listing. 


General 


List data across the width of a line rather than 
one item per line. Useful with large directory 
listings and individual options. 


Print the file DIRECT .HLP which describes the 
DIRECT program. 


List the directory for the specified device in 
reverse chronological order. Asa result, the 
most recently created files appear at the be- 
ginning of the listing. If /BK is used to list 
files in the public structure and multiple 
disks are in the public structure, the listing 
reflects reverse order for each disk. 


To list a directory at the line printer, the user specifies the device designator and op- 


tions in the command. For example, 


f LPQ:=* .BA?/F/W 


The command lists filenames and extensions of all files with BA in the extension. DIRECT 


formats the data across the width of the line printer paper. 


To list directories of several accounts and place them in a disk file, specify the project- 


programmer field and the disk file specification in the command. For example, 


: PRO -[120,*]/DI 


DIRECT creates the file PROJ.DIR in the current account and writes, to the file, directory 


listings of all accounts with project number 120, 


An error encountered in a command causes DIRECT to print a message followed by the 
# character. The user must retype the entire command correctly. The messages are described 


in Table 4-25, 
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4.13.1 DIR as a CCL Command. 


The following commands show some useful methods of requesting listings with the stand- 
ard CCL command DIR. To list the filenames and extensions of all files in the user's account, 


type the following command. 


DIR /BR/W 


DIRECT prints the listing at the user's terminal and lists the information across the width of 
the page. To list at another device the filenames, extensions, sizes, protection codes and 


creation dates for certain files in the current account, type the following command. 


DIR LPI:=*.BAS 
READY 


DIRECT prints the listing of all BASIC-PLUS source files on line printer unit 1. The READY 
message indicates DIRECT has completed printing. To obtain a reverse listing, type the 


following command. 

DIR /DI/BK 
DIRECT prints at the current terminal, directory and summary information in reverse 
chronological order. To print the file DIRECT.HLP on the line printer, type the following 


command. 


DIR LP1:=/HE 
READY 
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Table 4-25 
DIRECT Program Error Messages 


DEVICE NOT DIRECTORY Device specified doesnot use a directory for 
STRUCTURED file access. 


DIRECTORY OF dev:[n,m] IS EMPTY DIRECT finds of the account [n,m] on device 


dev: contains no entries. 


DISK PACK IS NOT ON-LINE The pack or cartridge referred to is either not 
mounted or is off-line, 


ILLEGAL FILE NAME <filename> The file specified by <filename> contains a 
logical device name which the user has not 
reserved by the ASSIGN command. 


ILLEGAL INPUT FILE SPEC file spec The file specification indicated by file spec 
generates RSTS error number 2, ILLEGAL FILE 
NAME. 


ILLEGAL SWITCH text File specification contains an undefined option 
indicated by text, 


INVALID DEVICE SPECIFICATION The device specification is invalid or the de- 
vice referred to does not exist on the system, 


NO DIRECTORY FOR [n,m] ON dev: DIRECT cannot find an account for user account 
[n,m] on the device dev: or else DIRECT en- 
counters a protection violation. 


NO HELP AVAILABLE The file DIRECT .HLP is not on the system 
library account. 


NO SUCH FILE AS <file spec> DIRECT cannot find the requested file indicated 
ON [n,m]. by <file spec> in the account [n,m]. 


OUTPUT FILE MUST BE IN THE DIRECT does not create an output disk file 
USER'S AREA in another account if user is not privileged. 


TOO MANY FILES FOR INVERTED DIRECT limits use of the /BK option to accounts 
DIRECTORY LISTING with less than 200 files. 
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4,14 UMOUNT PROGRAM - MOUNTING AND DISMOUNTING PRIVATE DISKS! 


A non-~privileged or privileged user can execute the MOUNT or DISMOUNT commands 
of the UMOUNT system program to logically mount and dismount private disk packs and car- 
tridges. The commands are executed only if the standard CCL feature is available on the 
system, Otherwise, the system prints the WHAT? error message. An attempt to run the 
UMOUNT program by any other means generates the message PLEASE USE THE 'MOUNT!' OR 
‘DISMOUNT! COMMAND. 


To logically mount a private pack or cartridge on the system, perform the following 


procedure, 
a. Load the pack or cartridge in the available drive. Ensure that the device is 
available by running the SYSTAT system program. 
b. — Ensure that the drive is write enabled. 
c. Type the MOUNT command followed by the device designator and the 
appropriate identification label. 


For example, 


MOUNT DK1:MYPACK 


READY 


The UMOUNT program runs and logically associates RK11 drive unit 1 with the identification 
label MYPACK, The READY message indicates that the disk is available for read and write 
access and in the UNLOCK state. 


An attempt to write a file on the disk when the current account is nonexistent generates 
the DISK PACK IS PRIVATE error (ERR = 24), The user must request the system manager or 


responsible system programmer to create the current account on the disk. 


If any error occurs in the device designator or in the identification label, the program 


prints the following error message. 


rc 


ar : 
This feature is not available prior to Version 5B (RSTS/E) systems. 
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ERROR IN MOUNT - <text> 
The text indicates the related RSTS-11 error encountered. The program terminates. 


If any error occurs in mounting the disk on the system, the program prints the following 


error message: 
PROCESS ERROR IN MOUNT - <text> 


The <text> indicates the related RSTS-11 error encountered. Some typical errors include 
having the device protected against writing (DEVICE HUNG OR WRITE LOCKED), specifying 
an incorrect identification label (PACK IDS DON'T MATCH) and trying to mount a disk which 
is already mounted (DISK IS ALREADY MOUNTED). 


If the program encounters an error when attempting to unlock the disk to enable write 


access, it prints the following message: 
ERROR UNLOCKING MOUNTED PACK - <text> 


The text indicates the related RSTS-11 error encountered. However, the pack is mounted and 
available for read access only. The user should report any error of this kind to the system 


manager or responsible system programmer, 


The UMOUNT program accepts options in the MOUNT and DISMOUNT commands! . 
If the disk to be mounted must be kept locked, simply append the /LOCK option to the MOUNT 


command. For example: 


MOUNT DBI:DATAI/LOCK 
READY 


UMOUNT runs and logically associates the identification label DATA] with RH11/RP04 unit 1. 
The READY message indicates that the disk pack is in the LOCK state, Only privileged users 


have read and write access to the disk pack 


The MOUNT command can be used with a magtape designator to assign a unit to the 


current job and to set default labeling format. The following example shows the procedure. 


MOUNT MT1:/DOS 
READY 


this feature is not available before Version 6A systems. 
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Magtape unit 1 is assigned to the current job with DOS/BATCH labeling default. The /ANSI 
option sets the labeling default to ANSI standard format. 


if the current job is privileged, the /JOB:n option can be used with a magtape designator 


and the MOUNT command to reassign the unit to job number n. For example, 


MOUNT MT1:/JOB:5 
READY 


Magtape unit 1 is reserved to job 5 with the currently assigned default labeling format. If 

job 5 is not active, an error message is printed. If an unassigned logical name is given for 

the magtape unit in the MOUNT command, UMOUNT prints the error text ERROR IN MOUNT - 
ILLEGAL DEVICE and returns to the READY level. If a name is given with the magtape designator 
in the MOUNT command, UMOUNT prints the message ERROR IN MOUNT - SYNTAX ERROR 
and returns to the READY level. 


To logically dismount a private pack or cartridge, perform the following procedure. 


a. By use of SYSTAT, determine the number of OPEN files on the device. If 
non-zero, wait until all files are closed before proceeding. If zero, proceed. 


b. Type the DISMOUNT command followed by the device designator of the drive. 
For example, 


DISMOUNT DKT: 
READY 


The UMOUNT program runs and logically dismounts the pack on RK11 drive 1. The pack 
identification is removed from the monitor's table of logical names. The READY message 
indicates that the drive is free for other usage and that the user can safely remove the pack 


or cartridge from the drive. 


If the program encounters an error when it attempts the dismount action, it prints a 


message in the following format. 
PROCESS ERROR IN DISMOUNT - <text> 


The <text> indicates the related RSTS-11 error encountered. A typical error is attempting to 


dismount a disk which has open files (ACCOUNT OR DEVICE IN USE). 
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To rewind a magtape and take it off line, use the /UNLOAD switch in the DISMOUNT 


command. For example: 
DISMOUNT MT@:/UNLOAD 


The magtape on unit 0 is rewound and placed off line. 
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4,15 FILCOM PROGRAM! 


The FILCOM (file compare) system program compares two ASCII files, line by line, and 
prints the differences found. The user must specify which two files are to be compared as well 
as how many successive lines must be compared at atime. This second consideration is espe- 


cially important for isolating differences in programs! subroutines, 
FILCOM is called as follows: 


RUN $FILCOM 


OUTPUT TO? 


Type the device designators of the peripheral device on which the comparison information 


is to be printed, Typing the CR key alone specifies the keyboard on which the user is working. 


The next two printed query lines request the names of the files to be compared. Be sure 


to use the full name of each file, including its extension. For example: 


INPUT FILE #12 SORT1,BAS 


INPUT FILE #2? SORT2,BAS 


Any number of lines can be compared at a time, The number of successive lines that 


determines a match is specified by the user response to the FILCOM query line as follows: 
HOW MANY TO MATCH? 


Responses to this query are discussed in detail later in this section, If the CR key is 


typed alone, the number of successive lines to match is automatically assumed to be three, 
The next query line is: 
BASIC+ LINES? 


Type the letter Y in response to this query to instruct the program to consider BASIC-PLUS 
continuation lines as part of the numbered line, In this way, multiple line statements can be 


compared, For example, consider the line shown below, 


"This feature is not available prior to Version 5B (RSTS/E) systems, 
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190 FOR J=YOTO 15: 
PRINT 3.14*J/2: 


NEXT J 


If Y were typed in response to the BASIC+ LINES query, FILCOM would compare all three 
statements (FOR, PRINT and NEXT) as a single line. By responding with any other character 
(or no character), FILCOM would compare only the statement printed on the first line (i.e., 
FOR J=18 TO 15) to a single line in the other file. Typing Y ensures that FILCOM prints the 
line numbers of any BASIC-PLUS lines found to be different. 


The next query line is: 
BLANK LINES? 


Typing the letter Y in response to this question instructs the program to compare blank 


lines. If the Y is not specified, FILCOM skips all blank lines. 


Assume the following two files are on the user's disk: 


TESTI TEST2 

16 REM A 19 REM A 

20 REM B 28 REM B 

3@ REM C 38 REM C 

4@ REM D 76 REM G 

50 REM E 8@ REM H 

60 REM F 90 REM 1 

78 REM G 1@@ REM J 
6@ REM H 119 REM 1 
90 REM 1 128 REM 2 
198 REM J 138 REM 3 
114 REM K 148 REM N 
120 REM L 159 REM O 
13@ REM M 168 REM P 
140 REM N 170 REM Q 
15@ REM O 188 REM R 
168 REM P 198 REM S 
176 REM Q 200 REM T 
18@ REM R 218 REM U 
198 REM S$ 228 REM V 
200 REM T 222 REM 4 
210 REM U 224 REM 5 
228 REM V 23@ REM W 
238 REM Ww 248 REM X 
240 REM X 250 REM Y 
256 REM Y 268 REM Z 
260 REM Z 
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EXAMPLE 1 


To compare these two files, TEST1 and TEST2, FILCOM is run as follows: 


RUN $FILCOM 
OUTPUT TO? 
INPUT FILE #1? TESTI»BAS 


INPUT FILE #2? TEST2.BAS 


HOW MANY TO MATCH? 
BASIC+ LINES? 
BLANK LINES? 


AGI OR IO IOI ok ka koe 
1) TEST1.BAS 

48 REM D 

S@ REM E 

6@ REM F 

70 REM G 

ok OR 

2) TEST2.BAS 

76 REM G 
JOO ROR OO IOI Ik 
1) TEST1-.BAS 

110 REM K 

120 REM L 

132 REM M 

148 REM N 

ok ORK 

2) TEST2.BAS 

118 REM 1 

128 REM 2 

138 REM 3 

148 REM N 

FIO OOO IO I OK a 
1) TEST!.BAS 

230 REM W 

OK Ok ak 

2) TEST2.BAS 

222 REM 4 

224 REM 5 

238 REM WV 


3 DIFFERENCES FOUND 


READY 
Notice that FILCOM prints the lines that do not compare equal in two files followed by 

the first line that does compare equal. The first line in each group is the first line that does 

not compare and the last line in each group is the first line that does compare. In general, the 
program does not print groups of lines that are identical, FILCOM first prints line 40 of TESTI, 
since it is the first line that does not appear in TEST2, This line is considered the first difference. 
FILCOM continues to print TEST! lines until it locates 3 lines that can be matched against 3 lines 
in TEST2, In this case, lines 70, 80, and 90 of both TESTI and TEST2 are identical, so the 


printout for this difference is ended, 
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Since lines 80 through 100 are identical in both files, FILCOM does not print them, The 
next lines that do not compare are lines 110 through 130. These lines are printed under both 
files, This is considered the second difference. FILCOM continues to print lines until it locates 


3 matching lines. Lines 140 through 160 are identical for both files. 


Since lines 150 through 220 are identical in both files, FILCOM does not print them. The 
next lines that do not compare are 222 and 224 of TEST2, Consequently, they are printed under 
the TEST2 heading. This is considered the third difference, FILCOM continues to print TEST2's 
lines until it locates 3 lines that can be matched against 3 lines in TEST1, Lines 230 through 
250 are identical for both files. 


Finally, FILCOM prints the number of differences found. If one of the two files compared 
were empty (e.g., an empty data file), FILCOM would have printed, A NULL FILE? ? 


EXAMPLE 2 


Files TEST! and TEST2 can be compared in another way. To compare these files for eight 


consecutive identical lines instead of three, FILCOM is run as follows: 


RUN SFILCOM 

OUTPUT TO? 

INPUT FILE #1? TEST1-BAS 
INPUT FILE #2? TEST2-BAS 
HOW MANY TO MATCH? 8 
BASIC+ LINES? 


36 fe I I 2 2 ak 2 eK i i a ak ok ak ak 
1) TEST1.BAS 

46 REM D 

5@ REM E 
68 REM F 
7@ REM G 
8@ REM H 
9@ REM I 
1@@ REM 
11@ REM 
129 REM 
13@ REM 
14@ REM 
2K KK kk 
2) TEST2-BAS 
78 REM G 


2Erna 


14@ REM N 
SOO ORR kK 
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1) TEST!.BAS 
236 REM W 

36 OK 

2) TEST2-BAS 
222 REM 4 
224 REM 5 
23@ REM W 


2 DIFFERENCES FOUND 


READY 


In this case, the first difference found, again, is line 40 in TEST1. Instead of matching 
lines 70 of both files, FILCOM begins to match line 140, since 140 to 220 is the next group of 


at least eight successive identical lines, Although lines 70 through 100 are identical in both 


files, they form less than eight successive lines. 


Now assume the following two files are on the user's disk: 


FILE 1 

THIS IS LINE 1 THIS 
THIS i& LINE 2 THIS 

THIS IS THE LINE AFTER THE ELANK LINE 
THIS IS THE NEXY LINE THIS 
THIS 

Notice that file 2 has an extra blank line. 

EXAMPLE 3 


FILE 2 


TS LINE @ 
IS LINE 2 


IS THE CINE AFTER THE &LANK LINE 
TS THE NEXT LINE 


To compare these two files, FILCOM is run as follows: 


RUNNH 

GUTFUT TO? 

INPUS FILE #47 FILE 
INFUT FILE #2? FILE? 
ROW MANY TO MAP CH 


BASIC+ LINES? NO 
BLANK LINES? NO 


B DIFTERKENCES FUUNDE 
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Since no response was typed after the query BLANK LINES?, FILCOM did not compare blank 
lines. Typing the letter Y in response to the BLANK LINES query, however, results in the 
printout shown below, 


RUN FILO 
GUTPUT TO? 


phe” Fie WetrILed 

HOw MAY 2 Me Ton? 

Borie LINES? NO 

BLANK LINES? VES 

sok RRR Kok boxe fokoR oR dob dot 

ta FILES 

THIS IS THE LINE AFTER THE ELANE LINE 
Heng kk 

2> FILE? 


THIS IS THE LINE AFTER THE BLANE LINE 


1 DIFFERUNCES | OUND 


READY 


If the user includes /P with a file name in response to the OUTPUT TO query, FILCOM 
creates the output file as a patch file, With the APPEND command, such a patch file can 
later be included in the file specified as INPUT FILE*2, This action makes the resultant file 
equivalent to the BASIC-PLUS program specified as INPUT FILE #1. To create the patch file, 
the user must also answer both the BASIC+ LINES and BLANK LINES query with YES, 
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4.16 INUSE PROGRAM! 


The INUSE system program prints or displays the words, "IN USE" in block letters on the 


terminal to warn others not to use it, This message is followed by the user's job number and 


account number, 


INUSE is called as follows: 


RUN $INUSE 


The printout from this program is shown below. 


RUN $INUSE 
IIIIII NN NN uu uu SS5565 EEEEEEEEEE 
IIIITI NN NN uu uu SSS555 EEEEEEEEEE 
Il NNNN NN uu uuess Ss SS EE 
II NNNN NN LIL uu SS 5S EE 
Il NNNN NN uu uu Ss EE 
II NNNN NN uu uu ss EE 
Il NN NN NN uu uu SSsssos EEEEEE 
I] NN NN NN uu uu SSSSss EEEEEE 
II NN NNNN uu uu SS EE 
Il NN NNNN UU uu SS EE 
Il NN NNNN Liu liu SS $& EE 
II NN NNNN uu! ues Ss oS EE 
TIIIII NN NN UULIULIU SEssss EEEEEEEEEE 
IIIIII NN NN UUUUIUL SSSS5S EEEEEEEEEE 


BY JOB 16 USER Ci20. 6@) 


Type the CTRL/Z or CTRL/C combination or execute any command to regain control of 
the terminal at any time, 


‘this feature is not available prior to Version 5B (RSTS/E) systems, 
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4.17 COPY PROGRAM! 


All of the information on a DECtape, magtape or disk can be copied by using the COPY 
system program and the /FC (fast copy) option. COPY is called as follows: 


RUN $COPY 


COPY prints a pound sign (#) when it is ready to receive instructions. To print a help message, 


simply type /HE. To copy a device, the user must respond in the format shown below. 


#new device<old device /FC 


For example: 
#DT1:<DT2:/FC 


In this example, all of the data, programs and directories are copied, block by block, 
from the DECtape on unit 2 to the DECtape on unit 1, The original information on unit 2 is, of 


course, still intact, 


Notice that all of the information on a device is copied; individual files cannot be 


specified, 


Magtapes, DECtapes, disk cartridges and disk packs can be copied. In addition, 
information can be copied only te different units of the same device. That is, COPY can be 
used to copy a DECtape to another DECtape or a magtape to anofher magtape, but not to copy, 
say, a DECtape to magtape or vice versa. If an attempt is made to copy the information on one 
type of device onto another type of device, the error message MUST HAVE SAME TYPE DEVICES 


is given, 


Finally, if the same unit number of a device is specified twice, the error message MUST 


HAVE DIFFERENT DEVICE UNITS jis given. 


When the information is successfully copied from one device to another, the program ter- 


minates and the system prints READY, 


"This program is not available prior to Version 5B (RSTS/E) systems. 
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To verify that the information on a device unit has been copied properly, use the /VE 


(verify) option with the COPY program in either of the following ways: 
#DT1:<DT2:/FC/VE 

or 
#DT1:<DT2:/NC/VE 


Since verification is performed block by block, it requires as much time as the copy operation. 
Therefore, it is important to understand the difference between the above commands. The first 
command shown above, which includes the /FC option, copies information from DT2 to DT] and 
then verifies that the information was copied correctly. The second command, which includes 
the /NC (no copy) option, does not copy information; it only verifies that the information on 


both DECtapes is identical. 


The two sample commands shown above are the only allowable forms for verifying. If the 
user types a command string omitting the /FC or /NC option, the error message /FC OR /NC 
MISSING -- PLEASE TRY AGAIN is returned. Typing a command string without specifying an 
option, gives the error message NO USEFUL OPTION SPECIFIED -- PLEASE TRY AGAIN, 


As with the /FC option, individual files cannot be specified with the /VE option; all of the 


information on a device is verified. 
As the verification is performed, the first message COPY prints is: 


BEGINNING VERIFICATION PASS 


If all of the information has been copied correctly from one device to another, the next message 
COPY prints is: 


VERIFICATION COMPLETE @ BAD BLOCKS 
READY 
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If, however, the information has not been copied correctly, COPY prints the decimal number 


of the blocks in which inconsistencies appear. For example: 


HDTII<DT2:/FC/VE 

BEGINNING VERIFICATION PASS 
THE FOLLOWING BLOCKS ARE BAD: 
17 


Isl 
Ol— 


VERIFICATION COMPLETE 3 BAD BLOCKS 


READY 


The /BL option, which specifies blocksize, speeds up copying or copies magtapes written 


with non-standard record sizes. To speed up copying, specify a larger blocksize. For example: 
#DKQ: <DKI:/BL:2848/FC 


causes the disk on drive DK1: to be copied to the disk on drive DK@: in 2048-byte blocks, 
rather than the default 512-byte blocks. 


To specify other than standard density and parity settings when copying magtape, use 


the /DENSITY:d and /PARITY:p switches where 


d can be: p con be 
200 ODD 
556 EVEN 
800 
DUMP 
1608 


(1688 implies phase-encoded.) For example, 
#MTQ:/DENSITY:556/PARITY : EVEN <MT1:/DENSITY:DUMP/FC 


COPY reads magtape unit 1 at 800 bits per inch dump mode and writes unit 0 in even parity 
at 556 bpi. 
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4.18 EXTENDED PIP PROGRAM! 


The PIP system program has been improved to provide the following features: 


accepting wild card characters in file name and extension 
specifications, 


inspecting eligible files for transfer, rename, and delete 
operations, 


pre-extending or extending an output file, 
writing zeroes over data before a file is deleted, 


reading DOS/BATCH format disks for copy and directory listing 
operations, 


handling ANSI format magtapes on transfer and directory listing 
operations, 


processing indirect commands, and 


continuing the command on the next physical line. 


The improved PIP is a new program, referred to as extended PIP. It requires a 16K word 


job area to run and is therefore optional on all systems. The standard 8K word version of PIP 


has not been altered. Extended PIP replaces the standard version on systems having the QUEMAN 


and SPOOL programs. To confirm the version of PIP available, simply type /HE while at PIP 


command le--el and the help file will be printed. 


Extended PIP has all the features of the standard version and includes those new features 


described in the following sections. For general information on PIP, refer to Section 4.4. 


NOTE 


For wild card processing in delete and rename 
commands, extended PIP uses a temporary file 
under the user's account to store directory 
information. If the user's account is full, PIP 
encounters the NO ROOM FOR USER ON 
DEVICE error when it attempts to open the 
temporary file. To overcome the error, use 
the KILL system command to delete one file 
and then rerun PIP. 


I this feature is not available prior to Version 6A (RSTS/E) systems. 
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4.18.1 Wild Card Specifications 


Extended PIP allows * and ? characters in file names and extensions to denote wild card 


elements and to thereby designate multiple files in a single file specification. 


The asterisk character (*) replacing a file name, an extension, or both denotes all file 
names, all extensions, or all file names with any extensions. The following samples demonstrate 


the usage of the * character. 


FILE .* All files with file name FILE and any extension 
* ,EXT All files with EXT extensions 
=e All files 


The question mark character (?) in any position of either the filename or extension means 
that any alphanumeric character can be substituted in that position to designate a file. The 


following samples demonstrate the usage of the ? character. 


FILE .EX? All files with name FILE and EX as the first two 
characters and any other character as the third 
character in the extension. 


FILE? ? .EXT All files with FILE as the first 4 characters and 
any characters as the fifth and sixth characters 
of the name and with EXT as the extension. 


FILE? ? .E?? All files with FILE as the first 4 characters and 
any characters as the fifth and sixth characters 
of the name and with E as the first character and 
any characters as the second and third characters 
of the extension. 


FI? EXT All files with an extension of EXT and with 
3-character names, of which the first 2 characters 
are Fl and the third character is any character. 


The * and ? characters can be intermixed in a file specification. The following samples 


show the default interpretations. 


FILE?? .* All files with any extension and with FILE as 
the first 4 characters and any characters as 
the fifth and sixth characters of the name. 


* EX? All files with EX as the first 2 characters and 
any character as the third character of the 
extension. 


In the absence of an element or elements of the full file specification, extended PIP sub- 
stitutes defaults for file names or extensions or both. The following default interpretations are 


applied to the incomplete specifications shown. 


Spec Default Meaning 

null ** All files 

* ae All files 

ar er All files with null extensions 
. aes All files with null extensions 

eEXT * ,EXT All files with extension EXT 

FILE FILE .* All files with name FiLE 


4.18.2 Extended PIP Defaults and Additional Options 


Wild card characters allow multiple files to be designated in the input and output of a 
PIP command. Multiple file specifications can be given on input: each must be separated by a 
comma. Where multiple file specifications appear as input in a PIP command, the default 


interpretations shown in Table 4-26 apply for missing elements in each specification. 


Table 4-26 
General Input Defaults 


Missing Element Default Interpretation 


Account The previously specified account. If missing from 
the first file specification given, the current user's 
account is the default. 


Device The previously specified device. If missing from 
the first file specification given, the public 


structure (SY:) is the default. 


File name The asterisk (*) specification 


Dot and extension! The asterisk (*) specification 


1 


If the dot is present, the extension is assumed to be present but can be null. When the 
dot is not present (and only then), the default extension is used. 
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On output, however, only one file specification is permitted although that file specification 
can designate multiple files. Only the asterisk (*) is permitted as a wild card character in an 
output specification. An attempt to use the question mark (?) in the output generates the 
INVALID DEVICE error. When the output is a wild card specification, the input specification 


is repeated for each file created as output. 


Extended PIP applies specific default values for all elements in a transfer or directory 
listing command, The input and output defaults are summarized in Tables 4-27 and 4-28. The 
defaults for rename and delete commands differ from those applied to transfer commands, 


(Sections 4.18.4 and 4.18.5 describe the individual differences.) 


Table 4-27 


Output Defaults for Transfer and Directory Commands 


dev: device specification The public structure (SY:) 


[proj, prog] project and programmer Current user account number 
(account) number 


file name specification Input file name is used 


file name extension The input specification 
is used 


protection code The system wide default 
(<6@>), the default set 
by the ASSIGN command, 
or the value specified in 
the input. 


no specification The current keyboard 


(KB:) 
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Table 4-28 


Input Defaults for Transfer and Directory Operations 


dev: device specification 


Immediately previous device 
specification. If none, 
then SY: is substituted, 


Immediately previous 
account number. If none, 
then current user account 
number is substituted, 


project and programmer 
(account) number 


[prci, prog] 


file name specification All files (Extended PIP 


substitutes the * character) 


All files with null 
extensions 


dot 


All extensions (Extended 
PIP substitutes the * 
character) 


file name extension 


protection code The system wide default 
or the default set by the 


ASSIGN command, 


no specification All files on the immediately 
previous device and 
account. If none, SY: 

and current user account 


are used, 


The new options available in extended PIP are described in Table 4-29. Either the < or 


= character can separate the input and output sides of the PIP command. 
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Table 4-29 
Additional Extended PIP Options 


Used in transfer, delete, and rename operations to inspect each 
file eligible for the operation. PIP prints the full specification 
of an eligible file and the ? character, To execute the opera- 
tion for thar file, YES (or any string beginning with Y) musr be 
typed. To omit the operation for that file, NO (or any string 

not beginning with Y) can be typed. 


The /IN option affects the individual file specification and 
not the entire command. For example, 


#A.*,B.*/IN.C.*/DE 


PIP deletes the files with names A and performs the inspect action 
for files with name B. It then deletes files with name C. 


Used on transfer operations to pre-extend a disk file to n blocks. 
If :n is omitted and the first input file is from disk or DECtape, 
pre-extend the output file to the length of the first input file. 


Cannot be used with the /UP option. 
Used on transfer operations to open the disk output file with 
MODE 2 (for appending date). (See Section 19.5.2 of the 
BASIC-PLUS Language Manual.) The output file is extended 
by appending the input file(s) to it. 


Cannot be used with the /PRX, /CL, and /UP options. 


Used on individual disk file specifications in delete commands. 
PIP writes zeroes in the file before it is deleted. The (WO 
option must appear with each file specification to which it 
applies, whereas the /DE option need appear only once in the 
command string. For example, 


#A BAKAVO,B.BAK/DE 


The /DE option applies to both files but the (WO option applies 
only to the file A.BAK. 


/MID: label Required when using the /ZE option on ANSI standard magtape. 
The label is an alphanumeric volume label of the magtape to be 


zeroed. The following example shows the format of the command. 


#MT1:/VID:ABC/ZE 
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Table 4-29 (Cont.) 
Additional Extended PIP Options 


a 


/NVID: label 


(cont.) 


The reel mounted on unit 1 is read. If the reel is in ANSI format, 
PIP prints the REALLY ZERO query only if the /VID: option is 

present and has a valid identification, A response of Y zeroes 

the magtape using the label ABC. If the reel is not ANSI format, 
PIP prints the REALLY ZERO query to allow the tape to be zeroed 
with the volume label ABC. (See Section A.3 of the RSTS/E 
Programming Manual for a description of a zeroed magtape.) 


/HE Prints the help file PIP.TXT. /HE must be the only element in 
the input specification. 


/ul Creates a directory listing. 


For RSTS/E disk, DECtape, and DOS format disk, the following 
data is printed: name, extension, length (C denotes contiguous 
for DOS disk files), RSTS/E protection code, and creation date, 


For DOS label magtape, the DOS protection code replaces the 
RSTS/E protection code and both the RSTS/E project-programmer 
number and the DOS user identification code are added to the 
listing. 


For ANSI label magtape, the protection code is not applicable 
and is omitted. 


/LI:S Creates a full (slow) directory listing. 


For RSTS/E disks only. Adds time of creation, date of last access, 
and file cluster size information to the standard directory listing. 


For other devices, prints the standard directory listing. 


/DOS Indicates that the input disk is in DOS/BATCH format, PIP can 
read the disk but cannot write on the disk. Thus, only transfer 
and directory operations are possible. 


/BLOCK Force an ANSI magtape input file to be read as if it were written 
in ANSI:U format. 


/FORMAT:U Forces an ANSI magtape output file to have an undefined format 
(contiguous mode transfer required). If /BL:n is on the input file 
specification, the output file block length is n bytes. 

/FORMAT:V Forces an ANSI magtape output file to have a variable length 
record format. If /BL:n is on the input file specification, the 


output file block length is n bytes. 


/MORE Continues a command on the next physical line. 
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4.18.3 Wild Card Specifications in Transfer and Directory Listing Commands 


For transfer and directory listing requests in extended PIP, the standard defaults described 
in Tables 4-27 and 4-28 are applied. The sample commands and accompanying text in this 
section demonstrate the defaults applied to transfer requests. The same defaults also apply to 
directory listing requests. The following example illustrates the defaults applied to a multiple 


file transfer request. 
#DK1:* BAK <* .BAS 


PIP transfers all files with BAS extensions from the current account in the public structure. 
Each eligible file is created as a unique file on RK unit 1 under the current account. Each file 
has the same file name as the input file but is given an extension of BAK and the default 


protection code. 


The following command shows the device and account defaults used when elements are 


missing from the input. 
#DK1:<60><MT@:[2, 2]* MAC, * BAK 


PIP first transfers all files with MAC extensions from account 2,2 on magtape unit @ to the 
current user account on RK unit 1. In the absence of a device and account designation in the 
second input specification, PIP uses the immediately previous device and account as default, 
All files with BAK extensions from account [2,2] on magtape unit @ are transferred to the current 
user account on RK unit 1. The files are created with a protection code of <6$>. (The 


magtape on unit % is rewound before the search for the BAK files begins.) 
The following command shows the default for a null input specification. 
#MTP:[5, 5] < , DK@:/BL:1924 


PIP transfers all files from the current user account in the public structure and all files 
from the current user account on RK unit @. Each input file is created on magtape unit @ with 
a project-programmer number of 5,5 and with the default protection code. The output records 


are written in 1824-byte blocks. 
The following command shows the use of the /DOS option. 


#DK1:<DT:, DK@:[128, 128]* MAC/DOS, SY:* BAS/FA 
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All files from DECtape unit 9; all files with MAC extensions under UIC 200,200 (octal) 
on the DOS disk from RK unit Q; and all files with BAS extensions under account 128,128 in 
the public structure are transferred to the RSTS/E disk on RK unit 1 with the default protection 
code. The /DOS switch applies only to RK unit J; the UIC must be specified in decimal. Since 
no account specification appeared in the last file specification, the previous account specifica- 
tion is used. Files from DECtape unit @ and from the public structure are transferred in formatted 
ASCII mode. Files from RK unit 9 are transferred in contiguous mode because they come from 


a DOS disk. 


The /IN option with a file specification causes PIP to list, one at a time as a query, the 
files eligible for transfer, This feature allows the user to inspect each eligible file and to 


selectively transfer each file according to the response given to the query. 


The /IN option must appear with each specification for which the inspect feature is to 


apply. For example, 
#* .*<DKG:[5,5]* .BAS/IN, * SRT/* .CBL/IN/FA 


In the command above, files with BAS, SRT, and CBL extensions on RK unit @ under 
account [5,5] are to be transferred to the public structure under the current user account. The 
inspect feature applies to files with BAS and CBL extensions because of the accompanying /IN 
option. To transfer an eligible file, type YES (or any string beginning with Y) in response to 
the inspect query. To omit an eligible file from the transfer, type NO (or any string not begin- 


ning with Y), Files with SRT extensions are transferred without the inspect feature being applied. 


4.18.4 Wild Card Specifications in Rename Commands 


For rename commands, extended PIP does not apply the standard defaults in all cases. In 
the output, device and account defaults are taken from those applied in the input and the pro= 
tection code is that of the input file. The device and account, therefore, need not be repeated 


in the output specification. For example, 
#* TMP=DK@:[5, 5]* .BAS/RE 


PIP renames all files with BAS extensions in account 5,5 on RK unit @ Each output file has 
the same name and protection code as the input file but is given the extension TMP. No trans= 


fer occurs and only files on RK unit @ are affected. 
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Except for protection code, the defaults in the input of a rename command are the same 
as those described in Table 4-28. The protection code of input files is preserved unless 
otherwise explicitly specified. The following example shows the device and account defaults 


applied on input. 
#* TMP=* SRT, DKQ:[5, 5]* SRT, DK1:* .SRT/RE 


Extended PIP renames all files with SRT extensions under the current account in the public 
structure; all files under account [5,5] on RK unit @: and all files with SRT extensions under 
account [5,5] on RK unit 1. The device and account defaults are applied whenever an 


explicit element is not given. 


If the null specification is given as input, all files in the current account on the public 


structure are used. For example, 
# TMP=/RE 


PIP renames all files and uses the name of the input file but gives the extension TMP. If 
a file of the same name exists currently, PIP prints an error message but continues the rename 


operation. 


The following command shows the defaults used when the protection code of files is 


changed. 
#DK1:* BAS<48>/RE 


The protection code of all files with BAS extensions under the current user account on RK 
unit 1 is changed to 48, The original name and extensions are preserved because no name and 


extension is given in the output. 


The /IN option in a rename command applies only to the file specification with which it 


appears. For example, 
#* BAK=DK1:* .BAS/IN, SY:* .BAS/RE 


Only the eligible files under the current account on RK unit 1 are listed for inspection. 
The eligible file is renamed only if YES (or any string beginning with Y) is typed in response 
to the inspect query. If NO (or any string not beginning with Y) is typed, the file is not 


renamed. After all eligible files on RK unit 1 are processed, the eligible files under the 


4-144 


current account on the public structure are renamed without the inspect action. If the inspect 
action is desired for the second specification also, the /IN option must appear twice as shown 


below. 

#DK1:* BAS/IN, SY:* -BAS/IN/RE 
As a result, the inspect action is applied to both specifications. 
4.18.5 Wild Card Specifications in Delete Commands 


For delete commands in extended PIP; device and account defaults are taken from the 
immediately previous device and account specified. If a device or an account is not explicitly 
specified, PIP applies the device and account defaults described in Table 4-28, The file 
name and extension must be explicit; extended PIP applies no defaults for either. The following 


commands show the proper procedure. 
#DK1:[5, 5]A.DAT,B.BAS/DE 


The files A.DAT and B.BAS in account 5,5:on RK unit I are deleted, The device and 
account defaults are applied for the specification B.BAS. The following command shows the 


defaults applied in absence of an explicit device and account. 
#4,DAT,B.BAS/DE 


The files A,DAT and B.BAS are deleted from the current user account in the nublic 
structure. The following command shows the usage of the immediately previous device specifi- 


cation, 
#ABC .*,DT1:ABC.*,* ABC/DE 


All files with name ABC are deleted from the public structure and from DECtape unit 1. 
For the third specification, PIP applies the immediately previous device default and deletes all 


files with extension ABC on DECtape unit 1. 


If the file name and extension are not explicit in a delete command, PIP prints an error 


message and terminates the operation. For example, the following commands generate errors. 


/DE (file name and extension is missing) 
.*/DE (file name is missing) 
*/DE (extension is missing) 
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The /IN option in delete commands applies only to the file specification with which it 


appears. For example, 
#DK1:* BAS/IN, SY:* .BAS/DE 


Only the eligible files under the current account on RK unit 1 are listed for inspection. 
The eligible file is deleted only if YES (or any string beginning with Y) is typed in response to 
the inspect query. If NO (or any string not beginning with Y) is typed, the file is not deleted. 
After all eligible files on RK unit 1 are processed, the eligible files under the current account 
on the public structure are deleted without the inspect action. If the inspect action is desired 


for the second specification also, the /IN option must appear twice as shown below. 
#DK1:* .BAS/IN, SY:* BAS/IN/DE 
As a result, the inspect action is applied to both specifications. 


4.18.6 Processing ANSI Magtape Files 


Extended PIP handles ANSI D, ANSI U, and ANSI F formats on input and ANSI D and 
ANSI U formats on output. Table 4-30 shows the transfers possible. 


Table 4-30 
Possible ANSI Magtape Transfers 
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Unless otherwise specified, Extended PIP transfers a magtape file in the format in which 


if was written. For example, 
#MT1:ABC .DAT<MT@:ABC .DAT 


The input file from unit 0 is created on the output unit 1 in the same format in which it was 


written. 


The format of the output file is altered if an option appears with the file snecification. 
Again, the only changes in format allowed are those shown in Table 4-30. To force Extended 
PIP to read the input file as ANSI U, the /BLOCK option is used. The /BLOCK ontion forces 
the input file to be read as if it were written in ANSI U format. The option must appear with 


the file specification to which it applies. For example, 
#SY :OUT <DK@:INP1, MT@:INP2/BLOCK, MT1 :INP3/BL:1024 


The output file SY:OUT is written with a block size of 1024. The disk file INP] is read 
with a block size of 1024, Because of the /BLOCK option, the magtape file INP2 is read as 
if it were written in ANSI U format with a maximum block size of 1024; that is, INP2 is read 
using GET statements without deblocking. The magtape file INP3, however, is read using the 
block size and record size with which it was written. If INP3 is in ANSI D format (variable 
record length), each record is deblocked to occupy one 1024-byte block on the disk. If 
INP3 is in ANSI U format (fixed record length), each block of input occupies one 1024-byte 
block on the disk. The /BLOCK option, therefore, causes files to be transferred more quickly 


since deblocking is not performed. 
The /BLOCK applies only to the file with which it appears. For example, 
#SY:OUT <DKQ: INP] »MT@:INP2/BLOCK/FA 


The output file SY:OUT is written in formatted ASCII mode. The input file INP1 is read 
as a formatted ASCII file and INP2 is read as an ANSI U format file. 


The /FORMAT:U and /FORMAT:V force the magtape output characteristics to the undefined 
format and the variable length record format, respectively. If neither switch appears, the files 


are processed according to the default assigned to the drive. For example, 


#MT@:<MTI: 
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If the input unit is not assigned as ANSI, the output files are written in ANSI U format. 
If the input drive is assigned as ANSI, each output file is written in the same format as the 
corresponding input file. Specifying an output file name causes the input files to be merged 
into one output file having the characteristics of the first selected input file. Table 4-31 


summarizes the effect of drive assignments in the above command. 


Table 4-31 
Effect of Labeling Default Assignments 


Output files are copied exactly from the input volume. 
All volume and file header information is copied. 


Output files are created as if in a contiguous mode 
transfer. No file attributes are copied because 
DOS does not support file attributes. Input files 
are read in the format in which they were written. 
(For example, an ANSI D file is read as a variable 
length record file.) 


Output files are written in ANSI U format. 
A formatted ASCII (the default mode in PIP) 


transfer is performed. 


(For information on assigning a labeling format to a magtape drive, see Section 2.7.4.) 


To force an output file to have either undefined or variable length record format, specify 
either the /FORMAT:U or the /FORMAT:V switch in the output. . 


4.18.7 Indirect Command Files in Extended PIP 


Extended PIP can execute commands froma file. Such a file is termed an indirect command 
file and is indicated by the commercial at (@) character. The commands in the file are executed 
when an indirect command is given. An indirect command has the @ character as the first 
character on the command line followed by the file specification. The following is the correct 


format for an indirect command. 


@[proj, prog] dev:file ext 
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The defaults are the current account in the public structure and the extension CMD. A 


file name must be specified in the command. The device can be either disk or DECtape. 


The indirect command file is an ASCII file containing extended PIP commands. Ifa line 
of the file begins with a semi-colon (;) character, PIP treats it as a comment line and skips to 
the next line of the file. The REALLY ZERO and inspect questions of the /ZE and /IN options 


are not printed when executed from an indirect command file. 


The indirect command can appear in the indirect command file. Ten levels of nesting are 
allowed. If more than 19 levels are attempted, the program prints the message INDIRECT 
COMMAND ERROR - COMMAND STACK OVERFLOW 


uv SIAwn wy e 


Most errors cause PIP to return to the base level - the level at which the first indirect 
command file was initiated. On the following errors, however, PIP simply prints the error 


message and continues processing. 


NO FILES MATCHING specification for /DE operations 
NO FILES MATCHING specification for /LI operations 


where specification is the full file specification 
FILE OR ACCOUNT ALREADY EXISTS for /RE operations 
The following command shows the procedure to execute an indirect command file. 


#@ ABC 


PIP reads the file named ABC .CMD in the current user account in the public structure. If 
only the designator KBn: appears in the indirect command, PIP reads the specified keyboard 
for commands, Execution of indirect commands from the keyboard is terminated when the 


CTRL/Z combination is typed. 


Since the logically assigned account (see Section 2.7.1) and the PIP indirect command are 
denoted in the same manner, the placement of the @ character on the PIP command line is 
important. For example, to obtain a directory listing of the logically assigned account, the @ 
character must be used with the /LI option, Because the @ character must be followed by a 


file name, the command @/LI generates an error. The following command, however, executes 


properly. 
#SY:@/LI 


The directory of the logically assigned account in the public structure is generated. 
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4.18.8 Extending the Physical Command Line - /MORE 


The option /MORE at the end of a command line causes PIP to print the text MORE > and 
space to the next tab position. The command line can thereby be continued on the next physical 
line. The entire command is not executed until /MORE does not appear in the command line. 


For example, 


#LPQ:=A .DAT,B.BAS,C .BAC/MORE 
MORE > D.BAK/LI 


PIP executes the /LI option for the files A.DAT, B.BAS, C.BAC, and D.BAK. 
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CHAPTER 5 


RSTS-11 PERIPHERAL DEVICES 


RSTS-11 has several peripherals which are available to the user. These devices include: 


user terminal (ASR-33, ASR-35, LA3@ & LA36 DECwriters, VT@5 & VT5@ displays) 
high-speed paper tape reader/punch 

card reader 

line printer 

DECtape 

magtape 


floppy disk 


While normal operation of a computer system is by programmed control, manual operation is 
necessary for some tasks. This chapter describes the manual control and operation of the 


common RSTS-11 user peripherals. 


5.1 ASR-33 TELETYPE 


The ASR-33 Teletype is an inexpensive, commonly employed user terminal. 


Major { 2atures are noted in Figure 5-1. 


OFF 
LINE () LOCAL 


Figure 5-1 ASR-33 Teletype Console 


The components of the Teletype unit and their functions are described on the following page. 
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5.1.1 Control Knob 


The control knob of the ASR-33 Teletype console has three positions: 


LINE The console has power and is connected to the system as an I/O device 
under RSTS-11 control. 

OFF The console does not have power. 

LOCAL The console has power for off-line operation under control of the 


keyboard and switches only. 


5.1.2 Keyboard 


The Teletype keyboard shown in Figure 5-2 is similar to a typewriter keyboard, except 
that some nonprinting characters are included as upper case elements. For typing characters or 
symbols such as $, %, or # which appear on the upper portion of numeric keys and some alpha- 


betic keys, the SHIFT key is depressed while the desired key is typed. 


Nonprinting operational functions are shown on the upper part of some alphabetic keys. 
By depressing the CTRL (control) key and typing the desired key, these functions are activated. 
Use of these CTRL/key combinations are described in Chapter 3 of this manual. ! 


ODDODOODOOOOOO® 
SOOD®OOOOOO@S 
QOOOODOOOO8O O08 


© ODOOOOOO00® 


Figure 5-2 Teletype Keyboard 


Talthough not shown on most keyboards, SHIFT/L produces the backslash character (\) and 
SHIFT/K and SHIFT/M produce the square brackets, [ and], respectively. 
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5.1.3 Printer 


The Teletype printer provides a printed copy of input and output at ten characters per 
second, maximum rate. When the Teletype unit is on-line to the system (control knob turned 
to LINE), the copy is generated by the computer (even the echoing of the characters typed 
by the user); when the Teletype unit is off-line (control knob turned to LOCAL), the copy is 


generated directly from the keyboard onto the printer as a key is struck. 


5.1.4 Low-Speed Paper Tape Reader 


The paper tape reader is used to read data punched on eight-channel perforated paper 
tape at a rate of 1f characters per second, maximum. The reader controls are shown in Figure 


5-1 and described below. 


START The reader is activated; reader sprocket wheel is engaged and operative. 

STOP The reader is deactivated; reader sprocket wheel is engaged but not 
operative. 

FREE The reader is deactivated; reader sprocket wheel is disengaged. 


The following procedure describes how to properly position paper tape in the low-speed 


reader. 


a. Raise the tape retainer cover. 
b. Set reader control to FREE. 


c. Position the leader portion of the tape over the read pins with the sprocket 
(feed) holes over the sprocket (feed) wheel and with the arrow on the tape 
(printed or cut) pointing outward (forward). 


d. Close the tape retainer cover, 


e. Make sure that the tape moves freely (if the tape does not move back and 
forth freely, the paper feed holes are not properly positioned). 


f. Set reader control to START, and the tape is ready. 


5.1.5 Low-Speed Paper Tape Punch 


The paper tape punch is used to perforate eight-channel rolled oiled paper tape at a max- 
imum rate of 18 characters per second. The punch controls are shown in Figure 5-1 and 


described on the following page. 


5-3 


RELease Disengages the tape to allow tape removal or loading. 


BSP Backspaces the tape one space for each firm depression 
of the BSP button. 


ON (LOCK ON) Activates the punch. 


OFF (UNLOCK) Deactivates the punch. 


Blank leader/trailer tape is generated by: 


a. Turning the control knob to LOCAL. 
b. Turning the punch control to ON. 
c. Typing the HERE IS key. 


d. Turning the punch control to OFF. 
e. Turing the control knob to LINE. 


5.2 HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 


One high-speed paper tape unit can be provided with each RSTS-11 system. This unit is 
mounted on the central computer console. A high-speed paper tape unit is pictured in 


Figure 5-3 and descriptions of the reader and punch units follow. 


PAPER TAPE OFF LINE 


Figure 5-3 High-Speed Paper Tape Reader/Punch 


5.2.1 High-Speed Reader Unit 


The high-speed paper tape reader is used to read data from eight-channel, fan-folded 
(non-oiled), perforated paper tape photoelectrically at a rate of 386 characters per second, 


maximum. 


NOTE 


Tape from the Teletype punch should not 
be used with the high-speed reader as the 
oil on the tape causes lint and dust to 
collect on the phofoeleciric ceils. 


Primary power is applied to the reader when the computer power is on, 


In order to use the high-speed reader as an input device, turn the reader ON LINE/OFF 
LINE rocker switch to ON LINE. Load tape into the reader as explained below: 


a. Raise the tape retainer cover. 


b. Place tape in right-hand bin with printed arrows pointing toward left-hand bin. 
(Channel one of the tape is toward the rear of the bin.) 


c. Place several folds of blank tape past the reader and into the left-hand bin. 


d. Place the tape over the reader head with feed holes engaged in the teeth of the 
sprocket whee. 


e. Close the tape retainer cover. 


f. Depress the FEED rocker switch until leader tape is over the reader head. 


The reader is capable of sensing whether a tape is in the reader. If an attempt is made to 


read a tape when the reader is either empty or OFF LINE, an error is generated. 
5.2.2 High-Speed Punch Unit 


The high-speed paper tape punch is used to record computer output on eight-channel , fan- 
folded, non-oiled paper tape at a rate of 5 characters per second maximum. All characters are 
punched under program control from the computer. Blank tape (feed holes only, no data), is 
produced by pressing the punch FEED rocker switch, The punch unit has power turned on when- 


ever the computer has power; it does not require any additional on/off switch. 


Fan-folded paper tape is generally grey in color. When a box of tape is nearly empty, 
purple tape is produced. Rather than risk running out of tape while punching, replace the box 


of paper tape at this point or notify the system manager who will replace the tape. 
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5.3 CR1I1 CARD READER 


The CR11 card reader allows the RSTS-11 system to accept information from punched 89 
column data cards. Cards can be read under program control at rates of up to 200 or 308 cards 


per minute. 


Power to the reader, shown in Figure 5-4, is controlled by the ON/OFF switch on the 
upper left hand corner of the back panel. Two toggle switches are present on the back panel 
and should be set to AUTO and REMOTE for proper operation. The LAMP TEST button on the 
reader back panel can be depressed to check the operation of the various reader lights on the 


front panel. 
In order to use the card reader: 


a. Remove card weight from input hopper. Place cards loosely in input hopper. The 
first card to be read is placed at the front of the deck, "9" edge down, column 1 
to the left. Replace card weight on top of cards in input hopper. Cards should not 
be packed tightly. 


b. Press green RESET button. Wait 4 seconds for RESET light to come on. The card 
deck is now able to be read under program control. 


c. Cards may be loaded while the reader is operating provided tension is maintained on 
the front of the deck as cards are added to the rear. Additional cards should not be 
loaded until the hopper is 1/2 to 2/3 empty. 


d. The output stacker bin can be unloaded while cards are being read. Care should be 
taken to maintain the order of the deck. 


The various lights and switches (buttons) on the reader front panel and their significance are 
described in Table 5-1. 


Table 5-1 
Card Reader Controls 


Light/Switch 
POWER light indicates that there is power to the reader. 


READ CHECK light indicates a reading error, torn card, or card too long for reader. 
Reader stops and. RESET light is out. 


PICK CHECK light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 


STACK CHECK light indicates inability to remove card from input hopper. Reader stops 
and RESET light is out. 
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Table 5-1 (cont'd.) 


Light/Switeh 


HOPPER CHECK light indicates that there are no cards in input hopper. or the output 
stacker is full. Condition must be manually corrected to allow further 
operation. 


button, when depressed, causes red light to go on momentarily. RESET 
light goes out and reader operation stops as soon as the card currently 
in the read station has been read. 


button, when depressed, causes green RESET light to go on and initial- 
izes card reader logic. 


Figure 5-4 CRI1 Punched Card Reader 


5.4 LPI LINE PRINTER 


The LP11 line printer, pictured in Figure 5-5, has an 80 column capacity, prints ata 
rate of 356 lines per minute at a full 80 columns, and can print 116 lines per minute at 20 
columns. These rates are based on a 64-character set. A 96-character set and 132-column 
version are also available. The print rate is dependent upon the data and number of columns to 


be printed. 


Characters are loaded into a 2@-character printer memory via a Line Printer Buffer. 
When this buffer is full, the characters are automatically printed. This process continues until 
the 88 columns (four print zones) have been printed or a carriage return, line feed, or form feed 
character is recognized, The printer responds only to codes representing the character set and 


three control characters. All other codes are ignored. 


/EIEZA 


—————————————— >. 


Figure 5-5 LP11 Line Printer System (88-column model) 


5.4.1 Line Printer Character Set 


The 64 character set consists of the 26 upper case letters (A - Z), ten numerals (0 - 9), 
27 special characters and the space character. The 96-character set contains all of the above 


plus 26 lower case letters and 6 additional symbols. The character codes are 7-bit ANSCII. 
Characters are printed 18 characters per inch and 6 lines per inch. 


Line printers can use paper varying in width from 4 inches to 9-7/8 inches for the 88-column 


printer. Forms making up to six copies can be used when multiple copy printing is desired. 


The special symbols available are as follows: 


64-character set 96-character set 

1 Fe %ye&ei() all of the 64-character 
BP pee of Ee set symbols 

Se BNL a “ { } = ~ DEL 


ASCII numeric equivalents for the various characters are contained in Appendix D. 


5.4.2 Line Printer Operation 


Figure 5-6 illustrates the line printer control panel on which are mounted three 
indicator lights and three toggle switches. Operation of these switches and the power switch, 


and the meaning of the lights is explained in Table 5-2. 


ON LINE 


© @ 


PAPER OFF LINE 
STEP 


Figure 5-6 Line Printer Control Panel 


Table 5-2 


Line Printer Controls 


Light/Switch 


POWER light 


Glows red to indicate main power switch (located inside cabinet) 
is at ON position and power is available to the printer. 


Glows white, shortly after the POWER light goes on to indicate 
that internal components have reached synchronous state , paper 
is loaded, and the printer is ready to operate. 


READY light 


Glows white to indicate that ON LINE/OFF LINE toggle 
switch is in ON LINE position, 


ON LINE light 
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Table 5-2 (cont'd.) 
Line Printer Controls 


ON LINE/OFF LINE switch This three-position toggle switch is spring-returned to center. 
When momentarily positioned at ON LINE it logically connects 
the printer to the computer and causes the ON LINE light to 
glow. Positioned momentarily at OFF LINE, the logical con- 
nection to the computer is broken, the ON LINE light goes off, 
and the TOP OF FORM and PAPER STEP switches are enabled. 

If printer is switched to OFF LINE, the ON LINE light remains 
on until either PAPER STEP or TOP OF FORM switch is activated. 
The printer should again be turned ON LINE. 


TOP OF FORM switch This two-position toggle switch is tipped toward the rear of the 
cabinet to roll the form to the top of the succeeding page. It 
is springteturned to center position, and produces a single top- 
of-form operation each time it is actuated. The switch is effec- 
tive when the printer is off line. 


PAPER STEP switch This two-position toggle switch operates similarly to TOP OF 
FORM but produces a single line step each time it is actuated, 
It is only effective when the printer is off line. 


ON/OFF (main power) switch| This switch controls line current to the printer, To gain access 
to it, the printer front panel is unlatched, by pushing the 
circular button on the right hand edge, and opened to the left 
on its hinges. The switch is located to the left of center approx- 
imately fourteen inches below the top. If power is available, 
the red POWER light on the control panel will glow when the 
switch is positioned at ON. 


The switch is on when in the up position. The ON and OFF 
labels are printed on the stem of the switch. A group of two 
switches and three indicator lights, above the main power 
switch, are for the use of technicians in making initial adjust- 
ments to the printer. 


The following procedure is used when loading paper in the line printer. 


a. Open front door of cabinet. POWER light should be on. Printer should be off line. 


b. Lift control panel TOP OF FORM switch and release to move tractors to correct 
loading position. 


c. Open drum gate by moving drum gate latch knob to left and up. Swing drum gate 
open. 


d, Adjust right hand tractor paper width adjustment for proper paper width if necessary. 
(Loosen set screw on 88 column printer; user release mechanism on 132 column 


printer.) Tighten tractor after adjustment. 


e. Open spring loaded pressure plates on both tractors. 
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f. Load paper so that the two red arrows point to a perforation. Paper should lie 
smoothly between tractors without wrinkling or tearing the feed holes. 


g. Close spring-loaded pressure plates on both tractors. 


h. Adjust COPIES CONTROL lever to proper number of copies to be made, if necessary. 
Set to 1 or 2 for single forms, set to 5 or 6 for six-part forms. 


i. Close drum gate and lock in position with drum gate latch. After 18 seconds the 
READY indicator should light. 


j. Lift TOP OF FORM switch several times to ensure paper is feeding properly. 
k. Set printer to on line. ON LINE indicator should light. At this point printed 


matter can be aligned with the paper lines, if desired, by rotating the paper 
vertical adjustment knob. 


DECtape units are available on most RSTS-11 systems. DECtape serves as an auxiliary 


magnetic tape storage facility to the system disks). 
A DECtape peripheral unit consists of three components: 


a. TU5S DECtape transport, pictured in Figure 5-7, which reads and/or writes infor- 
mation on magnetic tape. 


b. TC11 Controller, the interface which controls information transfer. One controller 
serves up to four transports (up to 8 tapedrives). The Controller is transparent to 
the RSTS~11 user. 


c. DECtape, the recording medium used for data storage, consists of reel mounted 
magnetic tape formatted to permit read/write operations in either direction, error 
checking, block identification, and timing control. 


Figure 5-7 TU56 DECtape Transport 
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DECtape stores and retrieves information at fixed positions on magnetic tape. The advan- 
tage of DECtape over conventional magnetic tape is that information at fixed positions can be 
addressed. Conventional magnetic tape stores information in sequential (not addressable direct- 
ly), variable-length positions. DECtape incorporates timing and mark information to reference 
the fixed positions. The ten-channel DECtape records five channels of information: a timing 
channel, a mark channel, and three information channels. These five channels are duplicated 
on the five channels remaining to minimize any possibility of information loss from the other 


channels. 


Each formatted (certified) DECtape contains 578 blocks of data consisting of 256 (16-bit) 
PDP-11 words per block. 562 blocks are available to the user on each DECtape (several blocks 


are used for file directories). 


Tape movement can be controlled by programmed instructions from the computer (i.e., 
through PIP) or by manual operation of switches located on the front panel of the transport. 
Data is transferred only under program control. The transport controls and lights are described 


in Table 5-3. 


Table 5-3 
DECtape Controls 


Light/Switch 


REMOTE/OFF/LOCAL 


This three-position rocker switch determines control of the 
DECtape unit. 


REMOTE enables computer control of the transport unit. 


OFF disables the transport unit. 


LOCAL places the transport unit under operator control 
from the external transport switches. 
FORWARD/REVERSE This two-position rocker switch enables manual winding of tape 
when transport unit is under LOCAL control. 


FORWARD causes tape to feed onto right-hand spool. 
REVERSE causes tape to feed onto left-hand spool. 


Unit selector 


The value specified by this eight-position rotary switch identi- 
fies the transport to the computer. A unit selector value of 1 
allows the tape on that unit to be accessed as device DT1: 
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Table 5-3 (cont'd.) 
DECtape Controls 


Light/Switch Function 
g 


WRITE ENABLE/WRITE LOCK 


This two-position rocker switch determines whether or not a 
taps can be written. Any tape can be searched and read; 
however when the WRITE LOCK switch is on, the tape is 
protected from accidental writing or program deletion. 


REMOTE light When lit, the tape unit is on-line. The tape unit is on-line 


when: 


a. REMOTE/OFF/LOCAL switch is in REMOTE position, and 


b. unit selector switch setting agrees with the DECtape unit 
currently being accessed. 


WRITE ENABLE light When lit, indicates that the WRITE ENABLE/WRITE LOCK switch 
is set to WRITE ENABLE, regardless of whether the REMOTE 


light is on or not. 


Operating procedures associated with DECtape units are described below. In order to 


mount a tape on a DECtape drive: 


Set the REMOTE/OFF/LOCAL switch to OFF. 


Place full DECtape reel on left spindle with label facing out. Press reel 
tightly onto spindle. 


c. Pull tape leader over the two tape guides and the magnetic head unfil it 
reaches the take-up reel on the right hand side of the tape unit. 


_ 4. — Wind loose tape end four turns around the empty right-hand reel by rotating 
right reel clockwise. 


e. Set REMOTE/OFF/LOCAL switch to ‘LOCAL. Verify that power is available 
to the tape unit. 


f, Depress FORWARD/REVERSE switch in the FORWARD direction to wind about 
15 turns onto the right-hand reel. This ensures that the tape is securely 
mounted, 


In order to operate the DECtape unit on-line: 


a. Set the REMOTE/OFF/LOCAL switch to either LOCAL or OFF and be sure 
power is available to the system. 


b. Load the appropriate DECtape following the instructions above. 
c. — If the DECtape write operation is to be inhibited (to protect tape from acci- 


dental damage), set WRITE ENABLE/WRITE LOCK switch to WRITE LOCK. 
If the write operation is desired on this tape, set switch to WRITE ENABLE, 
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Dial the correct unit number on the unit selector. (No two active DECtape 
units should have the same unit number.) 


Set REMOTE/OFF/LOCAL switch to REMOTE. Use of this DECtape unit is 
now under program control. 


When on-line operation of this unit is to cease, set REMOTE/OFF/ 

LOCAL switch to OFF or LOCAL, A moving tape can be stopped by quickly 
switching the REMOTE/OFF/LOCAL switch from REMOTE to LOCAL. The 
switch can be set to OFF when tape motion has stopped. 


To remove a DECtape from the tape unit: 


Set REMOTE/OFF/LOCAL switch to LOCAL, 


Depress and hold REVERSE switch until all tape is wound onto the left-hand 
tape reel. 


Set REMOTE/OFF/LOCAL switch to OFF. 


Remove full reel from left-hand spindle. 
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5.6 TM1I1/TUIO AND TJUI6 MAGTAPE CONTROL AND TRANSPORT 


Magtape is an optional! addition to a RSTS-11 system. Magtane is used to provide storage 
for large volumes of data and programs. Writing, reading, and search operations are performed in 
a serial manner. Transfer of information can be made between RSTS=11 and other computer 
systems because TJUI6 and TMI1 Controllers read and write information in industry-compatible 


format. 
The basic DECmagtape system consists of: 


a. The TUIO Transport, pictured in Figure 5-8, can read or write 
information on magnetic tape in seven or nine channels (tracks). 
The TJU16 Tape Transport reads and writes information on nine 
channels only, The TUIO reads and writes data at 800 bits per 
inch (BPI), and the TJU16 Tape Transport can be used to read 
and write magtape either at 800 BPI or at 800 BPI and 1600 BPI. 


b, The TMI1 Controller is an interface between the TUIO Tape 
Transport and the PDP-11 system. The RHI] or RH70 is an 
interface between the PDP-11 and the TMO2 Formatter/TUI6 
Transport. One controller, transparent to the RSTS-11 user, 
serves up to eight transport units. 


EA HAA 
Hd of dG 
Hog Hog 
TUTO Transport TJUT6 Transport 


Figure 5-8 DEC Magnetic Tape System 
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Transfer rate is up to 36,0@@ characters per second for the TUI@ and up to 72,00 characters 
per second for the TJUI16. Ten and one half inch magtape reels permit up to 249 feet of tape 


per reel. Rewind time for a reel of 2409 feet is approximately 3 minutes, end to end, 


5.6.1 Magtape Control Panel 


The magtape transport control panel is shown in Figure 5-9. This panel is located at the 
lower left of the TUI@ and TJUI6 front panel shown in Figure 5-8. Table 5-4 describes the 


tape transport controls and Table 5-5 describes the various tape transport indicators. 


LD END HFILE 
re 
OFF 
eae coco 
ON: LINE, 


ON- LIN _START. 


to |] eno |iF ile 

a 
OFF 

(Leon 


PwR ON ON-LINE. 


L__| 
OFF-LINE 


PWR OFF 


LOAD LOAD 


UNIT 
SELECT 


TU10 Control Panel TJU16 Control Panel 


Figure 5-9 Control Panels 


Table 5-4 
Magtape Transport Controls 


PWR ON/PWR OFF 


This two-position switch applies power to the TUIO Transport. 
(This switch does not exist on the TJU16 Transport.) 


ON-LINE/OFF-LINE This two-~position switch controls operation of the transport 
unit. ON-LINE allows system operation under program 
control; OFF-LINE allows manual operation. Tave unit 
cannot be remotely selected when switch is in OFF-LINE 


position, 


START/STOP This two-position switch controls starting and stopping of tape 


motion. STOP does not stop transport during a rewind operation. 


LOAD/BR REL This three-position switch energizes the vacuum system in the 
LOAD position (necessary for any operation). The BR REL 
position releases vacuum tension and allows reels to be manually 


rotated, Center position locks reel brakes, 


UNIT SELECT This eight-position rotary switch identifies the transport to the 
computer. A unit select value of 1 allows the tape on that unit 
to be accessed as device MT1:. No two transports should be 


set to the same number. 


FW D/REW/REV This three-position switch moves the tape in the selected 
direction, depending on activation of the START/STOP switch. 
FWD moves tape forward until BOT or EOT marker is sensed. 
REW rewinds tape onto the feed reel until BOT marker is sensed. 
REV rewinds tape until BOT marker is sensed; toggling the 


START/STOP switch again causes the tape to rewind off the reel. 


Table 5-5 
Magtape Transport Indicators 


PWR light 
(power) 


When lit, indicates that power is available to the transport unit. 


LOAD light When lit, indicates that vacuum system has been enabled, 


allowing either on-line or off-line commands. 


RDY light 
(ready) 


When lit, indicates that all I/O lines are enabled. Transport 
can accept processor commands provided SEL light is also lit. 


LD PT light 
(load point) 


When lit, indicates that BOT marker has been sensed; transport 
ready for operation. 


END PT light 
(end point) 


When lit, indicates that EOT marker has been sensed; all tape 
motion stops to prevent tape from winding off reel. 


Table 5-5 (cont'd.) 
Magtape Transport Indicators 


FILE PROT light When lit, indicates that writing on the tape is inhibited. This 
(file protection) is true if no file reel is mounted on feed reel hub or if a file 
reel is mounted without a write enable ring. 


OFF-LINE light When lit, indicates that transport can be operated manually 
and cannot be operated under program control. 


SEL light When lit, indicates that transport has been selected and is 
(select) completely on-line. Transport can read or write data. 


WRT light When lit, indicates that write-enable ring has been installed 
(write) on feed reel and transport can write on tape. 


FWD light When lit, indicates tape is moving in forward direction. 
(forward), 


REV light When lit, indicates that tape is moving in reverse direction. 
(reverse) 


REW light When lit, indicates that tape is being rewound; Tape continues 
(rewind) until BOT marker is sensed. 


5.6.2 Magtape Operating Procedures 


Whenever handling magnetic tapes and reels, it is important to observe the following 


precautions to prevent loss of data and/or damage to tape handling equipment: 


a. Handle a tape reel by the hub hole only. Squeezing reel flanges can damage 
tape edges when winding or unwinding tape. 


b. Never touch tape between BOT and EOT markers. Do not allow end of tape 
to drag on floor. 


c. Never use a contaminated reel of tape; this spreads dirt to clean tape reels 
and can affect transport operation. 


d. Always store tape reels inside containers. Keep empty containers closed so 
dust and dirt cannot collect. 


e. _ Inspect tapes, reels, and containers for dust and dirt. Replace old or 
damaged take-up reels. 


f. Do not smoke near transport or tape storage area. Smoke and ash are 
especially damaging to tape. 


g- 


h. 


Do not place transport near a line printer or other device that produces 
paper dust. 


Clean tape path frequently. 


To mount a tape reel on the magtape transport. 


a. 


Apply power to the transport. (Depress the PWR ON switch on the TUIO 
transport.) Ensure that the LOAD/BR REL switch is in the center position 
and that the ON-LINE/OFF-LINE switch is in its OFF-LINE position. 


Place a write-enable ring in the groove on the file reel if data is to be 
written on the tape. If writing is not required, be sure there is no 
ring in the groove. 


CAUTION 


Attempting to read a 7-track magtape reel mounted 
on a 9-tfrack transport, or vice versa, causes the 
RSTS system and most other operating systems to 
crash, It is suggested that the user clearly label 
magtape reels and magtape transports as either 
7-track or 9-track, 


Two or more magtape transports set to the same unit 
number cause the RSTS system and most other 
operating systems to crash when an attempt is 

made to access a unit by that unit number. It 

is suggested that the unit numbers of all magtape 
transports be set in some consistent order and 

that they be clearly labelled and never changed. 


Mount file reel onto lower hub with groove facing toward the back. 
Press reel tightly onto spindle; tighten center nut. 


Install take-up reel (top reel), if necessary, as described in (c) 
above. The top reel is generally permanent and should not require 
installation by the user. 


Place LOAD/BR REL switch to the BR REL position. 


Unwind tape from the file reel and thread tape over tape guides and 
head assembly as shown in Figure 5-10. Wind about five turns of tape 
onto take-up reel. 


Set LOAD/BR REL switch to LOAD position to draw tape into vacuum 
columns. Asa result, the LOAD light comes on. 


h. Select FWD and depress the START switch to advance the tape to the load 
point. When BOT marker is sensed, tape motion stops, the FWD indicator 
goes out and the LOAD PT indicator comes on. 


If tape motion continues for more than 1@ seconds, depress STOP, select 
REV, and then depress START. The tape will advance to the BOT marker 
before stopping. (This may be necessary if, in winding the tape manually, 
the BOT marker has already been passed.) 

Setting the ON-LINE/OFF-LINE switch to ON-LINE allows the transport to accept commands 


from the controller under program control. The transport is not fully on-line until the RDY and 


SEL indicators are lit. 
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Figure 5-10 Magtape Transport Threading Diagram 
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To remove a tape from the transport unit: 


a. Set ON-LINE/OFF-LINE switch to OFF-LINE position. 
b. Set START/STOP switch to STOP position. 
c. Set FWD/REW/REV switch to REW position. 


d. Set START/STOP switch to START position Tape rewinds until BOT 
marker is reached. 


e. Set LOAD/BR REL switch to BR REL position te release brakes. 


f, Gently hand wind the file reel in a counter clockwise direction until all of 
the tape is wound onto the reel. Do not jerk the reel. This may stretch or 
compress the tape which can damage data. 


g. Remove the file reel from the hub assembly. 


5.7 VT@5 ALPHANUMERIC DISPLAY TERMINAL 


The VT05 alphanumeric display terminal consists of a cathode ray tube (CRT) display 
and a self-contained keyboard, The VT05 keyboard operates as a typewriter keyboard except 
that no hard copy is produced, Each graphic character generated by typing at the keyboard is 
converted to a 5 by 7 dot matrix and displayed on a television-like screen. The full capacity 


of the screen is 20 lines, each containing 72 character positions for a total of 1440 characters. 


When power is applied to the terminal and the CRT filament is warmed up, a blinking 
indicator called the cursor appears at the leftmost position of the top line (line number 1) of 
the screen, The blinking cursor indicates the position which the next generated character 
will occupy on the screen. The cursor can be moved up, down, left, or right by the use of 
various control characters generated by keys located to the right of the keyboard. When a 
displayable character is generated, its representation is displayed and the cursor automatically 


moves right to the next character location until the cursor reaches character position 72. 


A speaker in the VTO5 emits an audible tone or beep when the cursor reaches charac 
ter position 65, This action warns the user that the cursor is within 8 spaces of the end of the 
line. (The speaker also beeps when the terminal or the computer generates the BEL character.) 
When the cursor reaches position 72 on a line, characters subsequently generated replace the 
character previously in position 72. Automatic carriage return or line feed is a hardware 
modification and terminals without the modification must be programmed to include these 


automatic operations, 
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The VT05 keyboard, shown in Figure 5-11, is similar to a typewriter keyboard except 


for the following operations keys: 


ALT 


CTRL 


LF 


CR 


RUBOUT 


TAB 


Generates the ESC character CHR$(27). 


Control key is used to generate various control 
character combinations. See Chapter 3 for a 
description of control characters. 


Generares the LINE FEED characrer CHR$(10)~ 
Generates the RETURN character CHR$(13). 
Generates the DEL character CHR$(127). 


Generates the HT character CHR$(9) and causes 
the cursor to move to the right to the next tab 
stop. Tab stops are preset eight character 

spaces apart and are at locations 1, 9, 17, 25, 
33, 41, 49, 57 and 65. Once the cursor reaches 
character position 65, the HT character moves 
the cursor right one position. Another HT 
character causes a RETURN and LINE FEED, 
leaving the cursor at position 1. 


A line feed typed with the cursor in the bottom line (line 20) causes all displayed data on the 


screen to move up one line and any data in the top line to disappear. This action is termed 


automatic scrolling and is useful when a large amount of data is transmitted from the computer 


to the VTO5 and is to be received and displayed. The user can employ the CTRL/S combina- 


tion described in Chapter 3 to temporarily suspend transmission of such output to the screen 


and enable examination of data currently displayed on the screen. The CTRL/Q combination 


resumes output. 


OOOWOOBOOOOWOOW 
SOOOOOOUOOUOODUE 
SODOOOOOUOOVOUOU 

BX VOOOOUHOOOORW 


Figure 5-11 VT@5 Keyboard 
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Four actions erase characters from the screen. A character is erased when the cursor 
is placed under it and a space character is generated. A character is replaced on the screen 
if the cursor is positioned under an existing character and another character is generated. 


The EOL and EOS special functions also erase characters from the screen, 


The DEL code, CHR$(127), generated by typing the RUBOUT key, is ignored and no 
visual indication occurs on the display, When the RUBOUT key is typed on a VT05 terminal 
directly connected to a RSTS-11 system, the system backspaces the cursor one character 
position, generates a space character in that position on the screen and in memory and back- 
spaces one character position again. A RUBOUT key typed on a VT05 terminal connected 
to a RSTS-11 system by a dial up line is treated as the RUBOUT key typed at a teleprinter 
unless the TTYSET SCOPE command is in effect for that line. Executing the 
SCOPE command causes the RUBOUT key to be treated as described above. 


The ALT key typed at a VTO5 generates the ESC character. When received by the 
VT05, the ESC character has no effect on the display. RSTS-11 system programs such as 
GRIPE treat the ESC character as a line terminating character; the system echoes the $ 


character on the display when the ESC character is received. 


Controls to adjust the quality of the display are located on the right hand side of 
the terminal shown in Figure 5-12. Means to select a baud rate and mode of operation are 
on the rear panel of the device. At speeds above 300 baud, FILL characters for time delay 
as shown in Table 5-6 are required after some control characters are generated. The number 


of FILL characters required depends upon the baud rate at which the terminal operates. 


Table 5-6 


FILL Characters Required for VTO5 


Baud Rate Number of FILL 
Characters 


To effect the proper number of FILL characters on a VTO5 terminal which operates above 
300 baud and whose characteristics are not permanently set, use the FILL command of the 


TTYSET system program. 
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Figure 5-12 VTO5 Alphanumeric Display Terminal 


5.7.1 Controls and Operating Procedures 


The controls and switches for a VTO5 terminal are listed and described in Table 5-7. 


To start the terminal connected by a direct line to the RSTS-11 system, do the following. 


a. Set the LOC/REM switch to the REM position. 


b. Set the ON/OFF switch to the ON position. Allow approximately one 
minute for the filament to warm up, for the blinking cursor to appear in 
the home position (upper left corner of the display), and for the speaker 
to emit one beep. 


c. If the cursor fails to appear as specified, press the HOME key. Ensure 
that the BRIGHTNESS control is not turned fully counterclockwise. If 
the cursor still fails to appear, place the ON/OFF switch in its OFF 
position and report the malfunction to the proper person. 


d. To properly adjust the clarity of the display, turn the CONTRAST control 
counterclockwise to its minimum setting. Turn the BRIGHTNESS control 
counterclockwise until the characters are barely visible. Adjust the 
CONTRAST control to the optimum level. 
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e. When the operating session is completed, set the ON/OFF switch to its OFF 
position. 


To operate the VTO5 terminal which is connected to the computer by a dial up line, 


perform the following steps. 


a. Follow the procedures to start the VTO5 terminal as if it were connected by a 
direct line to the RSTS-11 system and set the BAUD RATE selector switch on 
the rear panel to its 110 position or to the position required by the permanent 
default characteristics established by the system manager for that line. 

og in procedures. If the line does not 


t 
a VT05, continue with step c. Other- 


nn 
oh 
° 
et es 


have permanent default characteristic 
wise, go to step e. 


Table 5-7 
VT05 Controls and Switches 


Location Operation 


Keyboard ON/OFF When placed in its ON position, power is 
applied to the VT05 display and the refresh 
memory is cleared, When placed in its OFF 
position, the VTO5 is inoperative and the 
screen is darkened. 


LOC/REM When placed in its LOC position, it breaks 
the electrical connection between the device 
and the computer. Local operation for main- 
tenance and training is still allowed. In its 
REM position, it connects the terminal to the 


remote computer system. Data is simultaneously 
transmitted to and received from the computer. 


Right Side BRIGHTNESS Turning this control in the clockwise direction 
increases the brightness of the screen. Turning 
the control counterclockwise decreases bright- 
ness, If turned fully counterclockwise, the 
display is completely darkened. 


CONTRAST This control increases and decreases the clarity 
of the characters displayed on the screen, 


VERTICAL This control synchronizes the display in the 
vertical position such that all 20 lines are 
visible on the screen. 
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Table 5-7 (Cont). 
VTO5 Controls and Switches 


HORIZONTAL 


This control moves the display in the 
horizontal direction such that all 72 character 
positions are visible on the screen. 


BAUD RATE This 10-position selection switch determines 
the rates at which the terminal transmits and 


receives data. 


Rear Panel 


FULL/HALF DUPLEX When at FULL, it allows the keyboard to 
transmit data to the computer and allows the 
display to simultaneously receive data from 
the computer. When at HALF, data is trans- 
mitted to the VTO5 receiver logic as well as 


to the computer. 


c. Run the TTYSET system program and type the VT05 macro command or the SPEED 
command with the proper baud rate value. (The maximum baud rate allowed on a 
voice grade telephone line is 300.) 


d. Set the BAUD RATE selector switch on the rear panel to the proper value, after 
which the VT05 operates at the proper baud rate. 


e. When the operating session is completed, set the BAUD RATE selector switch to 
the 110 position and set the ON/OFF switch to its OFF position. 
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5.8 2741 COMMUNICATIONS TERMINALS | 


RSTS-11 systems allow the use of 2741 tempatible’ terminals for time sharing operations. 
2741 terminals employ a Selectric typing mechanism which provides high quality copy in upper 
and lower case format. Such copy is especially suitable for documentation preparation and for 


output of the RUNOFF system program, 


The 2741 terminal operates in half duplex mode and transmits and receives non-ASCll 
characters, The terminal echoes locally; the computer does not echo the characters. This 


action differs greatly from ASCII terminals which operate under RSTS/E in full duplex mode. 


Half duplex operation of the 2741 terminal involves stricter intercommunication between 
the device and the computer. For example, when the user types the RETURN key to enter a 
line, the keyboard locks until the computer accepts the line and sends an EOT character to 
unlock the keyboard, This locking and unlocking action is noticeable and may be annoying to 
the fast typist. 


Many graphic code and keyboard arrangements are available for 2741 compatible 
terminals, RSTS-11 supports the four most common codes: Correspondence, Extended Binary 
Coded Decimal, Binary Coded Decimal and CALL 360 BASIC, Since the system can be con- 
figured for any combination of the four codes, it is advisable to consult the system manager for 


information concerning which codes are available at the local installation, 


274] terminals do not generate all the characters normally used for time sharing operations 
under RSTS-11, The system interprets certain keys in special ways described in the following 
subsections, The four supported keyboard arrangements are shown in Figures 5-13 through 5~16 


at the end of the section, 


5.8.1 The ATTN Key 


The 2741 terminal has an ATTN (Attention) key usually on the upper right hand portion of 
the keyboard. (Some terminals have an equivalent key called the BREAK key.) The key has 


"This feature is available only on Version 5 (RSTS/E) systems, 


are RSTS/E 2741 code has been tested with IBM, DATEL, and TREND DATA terminals. 
Digital Equipment Corporation makes no commitment to support 2741-type terminals 
made by other manufacturers. 
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several uses under RSTS-11 depending upon whether the terminal is transmitting data to or 


receiving data from the computer. 


The terminal is considered transmitting data to the computer when it is at BASIC-PLUS 
command level or in the program input state, The terminal is receiving characters whenever the 


system performs output to the device, 


When the terminal is transmitting data, the ATTN key can have two effects, If pressed 
while the SHIFT key is in its upper case position, the key generates the effect of a CTRL/C 
combination as described in Chapter 3. The system echoes the transmission as 
either! C or¢C, If pressed while the SHIFT key is in its lower case position, the key generates 
the effect of a CTRL/U combination (erase line) as described in Chapter 3, The system echoes 
the lower case ATTN key as either 'U or¢U, 


When the terminal is receiving data, pressing the ATTN key with the SHIFT key in its 
upper case or lower case position generates the effect of a CTRL/C combination as described in 


Chapter 3, This action allows the user to interrupt computer printout and return control to 
BASIC-PLUS command level. 


NOTE 


The system reacts to the CTRL/C combination 
on a 274] type terminal as if the user typed 
two such combinations in rapid succession, 
Programs executing the CTRL/C trap enable 
system function cannot trap a CTRL/C com- 
bination from a 2741 type terminal. 


5.8.2 The RETURN Key 


The RETURN key generates one of two characters depending upon whether the SHIFT key 
is in its upper or lower case position. If typed as a lower case character, the key generates a 
CR character (CHR$(13)). If typed as an upper case character, the key generates a LF charac- 
ter (CHR$(10)), The system thus allows the user to continue BASIC-PLUS statement lines when 


he enters source code from a 2741 terminal. 


5.8.3 The BKSP Key 


The BKSP key generates one of two characters depending upon whether the SHIFT key is 
in its upper or lower case position. If typed as an upper case character, the key backspaces 
the typing element one character position and generates the BACKSPACE character (CHR$(8)), 
If typed as a lower case character, the key backspaces the typing element one character posi- 


tion and generates the DEL (RUBOUT) character (CHR$(127)), In the latter case, the system 
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deletes from memory the last character typed. This action is similar to the RUBOUT key typed 
at an ASCII terminal except that any replacement character typed is printed over the deleted 


character. 
5.8.4 Bracket Characters 


Since most 2741 terminals have no bracket characters, the system accepts ( and ) charac- 
ters typed in place of [ and] characters. This feature allows users to delimit a project- 
programmer number with open and close parenthesis characters rather than with bracket char- 
acters. For example, (100,100) is equivalent to [100,000]. System programs translate [ and ] 


ian pee ON Dee, tae Ie eee ee a ere | 
o (and ) characters before processing commands. 


5.8.5 Changing Codes 


If the system is configured to handle more than one transmission code, the user can change 
the code recognized by the system. This feature is available because the system initializes 
each device to a default code when time sharing operations begin, Therefore, if an individual 
terminal does not employ the default code, the user must change the code to operate on the 


system, 


To enable the system to recognize codes generated by one of the keyboards shown in 
Figures 5-13 through 5-16, the user must type the numeral 1 followed by the upper case ATTN 
key. (See the description of the ATTN key in Section 5.8.1). For example, 


1¢C 
E963 
Ready 


As a result, the system changes the code conversion table for the device. It prints an 
identifier which associates both the code and its required typing sphere and prints the Ready 


message, Table 5-8 shows the identifiers and related reference information, 
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Table 5-8 


2741 Transmission Code Identifiers 


Correspondence 1167-029 


EBCD 1167-963 
BCD 1167-938 
CALL/360 BASIC 1167-087 


The code table the system uses and the typing sphere the device uses must match the par- 
ticular keyboard, If either the typing sphere or the code table is incorrect, the terminal produces 


garbled output. For example, 


I'g 
x92# 


Nupvi 


To verify the typing sphere, the user can compare the typing sphere number shown in Table 5-8 
with that stamped on the top edge of the type ball under the retaining clamp lever. To verify 
the keyboard, compare it with the one shown in the figure referred to in Table 5-8. If the 
typing sphere does not match the keyboard, install the correct type ball, Otherwise, continue 
changing codes until the system prints a recognizable identifier and Ready message. If the user 
changes codes four times and the system does not print a recognizable message, the terminal 


cannot be used unless the system is regenerated to support that code and keyboard arrangement. 


The graphics of the typing spheres for each keyboard are compatible with conventional 
system graphics except for certain special characters. Where differences exist, the conventional 
character is shown in the related keyboard layout above the graphic printed by the sphere. All 
system programs accept lower case characters by performing a conversion to upper case with the 
CVT$$ function described in Section 12.5 of the BASIC-PLUS Language Manual. 


Correspondence Code Keyboard 


The following special characters and system actions are produced on this keyboard. 


Character or Action 2741 Method 

LF (Line Feed) RETURN key in upper case 

CR (RETURN) RETURN key in lower case 

DEL (RUBOUT) BKSP key in lower case 

BKSP (BACKSPACE) BKSP key in upper case 

CTRL/C combination ATTN key in upper case 

CTRL/U combination ATTN key in lower case 

CTRL/O combination None 

CTRL/Z combination None 

Change Code 1 followed by the upper case 
ATTN key 


Figure 5-13 shows the correspondence keyboard layout and specifies the required typing 
sphere. Special system characters such as t, and\, which do not have a graphic equivalent 
are shown in the area above the key that is used as a replacement. For example, the terminal 
prints the ¢ character to designate the | character. Abbreviations above or below keys are 


defined in the legend. 


UC=BKSP notes 


< t 
aca Vee | EE) LE] Lee] ed bes 


tC = RUBOUT 
UCtiF 


aogsammon goal 
eel) &) PE ee) ee Ele 


ITO HO Oe oo 1) 
— wna } 


CORRESPONDENCE CODE - STANDARD SELECTRIC KEYBOARD LEGEND: 
1167-029 TYPE BALL UC= UPPER CASE 
UPPER AND LOWER CASE LETTERS LC = LOWER CASE 


CR= CARRIAGE RETURN. 


Figure 5-13 Correspondence Code Keyboard 
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EBCD Keyboard 


The following special characters and system actions are produced on this keyboard. 


2741 Method 


Character or Action 


LF (LINE FEED) 

CR (RETURN) 

DEL (RUBOUT) 

BKSP (BACKSPACE) 

CTRL/C combination 
CTRL/U combination 
CTRL/O combination 
CTRL/Z combination 
Change Code 


RETURN key in upper case 
RETURN key in lower case 
BKSP key in lower case 
BKSP key in upper case 
ATTN key in upper case 
ATTN key in lower case 
None 
None 
1 followed by the upper case 
ATTN key 
Figure 5-14 shows the EBCD keyboard layout and specifies the required typing sphere. 
Special system characters such ast , and \ which do not have a graphic equivalent are 
shown in the area above the key that is used as a replacement. For example, the terminal 
prints a ¢ character in place of the | character, - Abbreviations above or below keys are 


defined in the legend, 


SPACE ] 


LEGEND: 
EXTENDED BINARY CODED DECIMAL [EBCD) te ctoWEese hse 
1167-963 TYPE BALL BKSP = BACKSPACE 


LF = LINE FEED 
UPPER AND LOWER CASE LETTERS CR=CARRMGE RETURN 


Figure 5-14 EBCD Keyboard 
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BCD Keyboard 


The following special characters and system actions are produced on this keyboard, 


Character Action 2741 Method 

LF (LINE FEED) RETURN key in upper case 

CR (RETURN) RETURN key in lower case 

DEL (RUBOUT) BKSP key in lower case 

BKSP (BACKSPACE) BKSP key in upper case 

CTRL/C combination ATTN key in upper case 

CTRL/U combination ATTN key in lower case 

CTRL/O combination None 

CTRL/Z combination None 

Change Code 1 followed by the upper case 
ATTN key 


Figure 5-15 shows the BCD keyboard layout, and specifies the required typing sphere. 
Special system characters such as f, and \, which do not have a graphic equivalent are 
shown in the area above the key that is used as a replacement, For example, the terminal 
prints the ¢ character to designate the t character, Abbreviations above or below keys are 


defined in the legend. 


SEE 
UC=BKSP NOTES 


EE JDO HOOORPOOD ODE Oe ae 
ee eae 
AIO AAAwA OOo 

CI 


5 
SHAE OMAOOD Go. 
Fe SPACE 
BINARY CODED DECIMAL [8CD) LEGEND: 


1167-938 TYPE BALL uc: an CASE 
PI LC = LOWER CA‘ 
UPPER AND LOWER CASE LETTERS Hea 
LF = LINE FEED 
CR= CARRIAGE RETURN 


Figure 5-15 BCD Keyboard 
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CALL/360 BASIC Keyboard 


The following special characters and system action are produced on this keyboard, 


Character or Action 2741 Method 

LF (LINE FEED) RETURN key in upper case 

CR (RETURN) RETURN key in lower case 

DEL (RUBOUT) BKSP key in lower case 

BKSP (BACKSPACE) BKSP key in upper case 

CTRL/C combination ATTN key in upper case 

CTRL/U combination ATTN key in lower case 

CTRL/O combination None 

CTRL/Z combination None 

Change Code 1 followed by the upper case 
ATTN key 


Figure 5-16 shows the CALL/360 BASIC keyboard layout and specifies the required typing 
sphere. Special system characters such as t,\, [, ?, and] which do not have a graphic 
equivalent are shown in the area above the key that is used as a replacement. For example, 
the terminal prints a ¢ character to designate the | character, Abbreviations above or below 


keys are defined in the legend. This keyboard does not produce lower case letters, 


Cc 7? 3 \ NOtes 
OOH | Oe Ise 


UC=LF 


2 TAB [aa hal lie [| a Le] ul Al [Lo] El 
ras|[oce |(8] [$] | 2 LW |, 


w= Git) Ger eye) ae ae 
SPACE | 


CALL 360 BASIC CODE LEGEND: 
1167-087 TYPE BALL UC= UPPER CASE 
ALL LETTERS ARE UPPER CASE LC = LOWER CASE 


27] 
EI] 
o | 
E | 
EY 
F | 


BKSP = BACKSPACE 
LF = LINE FEED 
CRECARRIAGE RETURN 


Figure 5-16 CALL/360 BASIC 
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5.9 LA36 DECWRITER II 


DECwriter II offers fast, reliable operation and can be easily interfaced as a remote 
terminal or local computer 1/O device. This terminal prints 30 characters per second and up 
to 132 characters per line. Characters are formed from a 7 x 7 dot matrix. Character spacing 
is 10 characters per inch, horizontal and 6 lines per inch, vertical. An original and up to five 


copies can be printed, and forms can be any width from 3 inches to 15 inches wide. 
Table 5-9 describes the purpose of each operator control on the DECwriter II. 


Table 5-9 
DECwriter I! Operator Controls 


Power On-Off Applies and removes AC power to entire 
machine. 


Line/Local Selects on line or local operation. 


Baud-rate - 110, 150, 300 


3-position switch selects the baud rate clock 
frequency for communications line operation. 


Forms thickness adjustment Located on right side of print head carriage. 
Selects proper gap for 1- through 6-part form. 


Approximately 1 click for each part. 


Right Tractor Adjustment Thumb screw may be loosened to allow move- 


ment of right tractor for various forms widths. 


Fine Vertical Tractor 
Release 


Line feed knob may be depressed inward and 
rotated in the approximate direction for precise 
location of printing with respect to vertical 

zones, 
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5.10 RX11 FLOPPY DISK 


The RX11 floppy disk system provides a low cost, random access, mass memory device 
capable of storing up to 256,256 8-bit bytes of data in a non-file structured format. The 
floppy disk itself is a thin flexible, oxide-coated disk, similar in size to a 45 RPM phonograph 
record. The disk is recorded on one side and is housed in an 8 inch square flexible envelove. 
The envelope has a large center hole for the drive spindle, a small hole for track index 


sensing, and a larger slit for the read/write head. 


Each RX11 floppy disk controller handles one or two drives, mounted side-by-side 
horizontally. The lower numbered unit is on the left; the higher numbered unit on the right. 


RSTS/E systems support up to four controllers (and eight drives). 


Once power is applied to the floppy disk system, raise the door of the desired disk drive 
by pulling up on the centrally located latch. Then simply insert the floppy disk (still housed 
in its square envelope) into the drive, label-side up, and read/write head slit first. Close the 
door firmly. The floppy disk is now ready to use; the disk rotates at its operating speed 


immediately. 


To remove the disk, simply open the door and pull the disk envelope out. Once again, 


the disk stops rotating as soon as the door is opened. 


APPENDIX A 
BASIC-PLUS LANGUAGE SUMMARY 


All manual section numbers given in this Appendix refer to sectious in 


the BASIC-PLUS Language Manual. 


A.1 SUMMARY OF VARIABLE TYPES 


Type 

Floating Point 
Integer 
Character String 
Floating Point 
Matrix 


Integer Matrix 


Character String 
Matrix 


Variable Name 


Single letter 


optionally followed by a 


Single digit 


any floating point 
name followed by a 


any floating point 
name followed by a 


variakle 
% character 


variable 
$ character 


any floating point variable 
name followed by one or two 
dimension elements in 
parentheses 


any integer variable name 
followed by one or two dimen- 
sion elements in parentheses 


any character string variable 
name followed by one or two 
dimension elements in paren- 
theses 


A.2 SUMMARY OF OPERATORS 


Type 
Arithmetic 


Relational 


Logical 


String 


Matrix 


Operator 


unary minus 
exponentiation 
multiplication, division 
addition, subtraction 


+ #1 


. * 


m™ 


equals 

less than 

less than or equal to 
greater than 

greater than or equal to 
not equal to 
approximately equal to 
exactly equal to 

NOT logical negation 

AND logical product 

OR logical sum 

XOR logical exclusive or 
IMP logical implication 
EQV logical equivalence 


N Mion ee 


i ividll 


+ concatenation 


+,- addition and subtraction 


of matrices or equal dimen- 


sions, one operator per 


statement 

* multiplication of con- 
formable matrices 

* scalar multiplication of 


a matrix, see Section 7.5.1. 
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Examples 


A 
I 
X3 


BS 
D7% 


MS 
R1$ 
§ (4) 
N2 (8) 


E(5,1) 
V8 (3,3) 


A& (2) 
E3% (4) 


I3(3,5) 
R2% (2,1) 


C$ (1) 
A2$ (8) 


S$ (8,5) 
V1$ (4,2) 


Operates Upon 


numeric variables 
and constants 


string or 
numeric variables 
and constants 


numeric variables 
string variables 
integer variables 
and integer-valued 
expressions 


string constants 
and variables 


dimensioned vari- 
ables. See Sec- 
tion 7.6.1 for 
further details. 


A.3 SUMMARY OF FUNCTIONS 
Under the Function column, the function is shown as: 
Y=function 
where the characters % and $ are appended to Y if the value returned 
is an integer or character string. 


A floating value (xX), where specified, can always be replaced 
by an integer value. An integer value (N%) can always be replaced 
by a floating value (an implied FIX is done) except in the CVTs$ 
and MAGTAPE functions (the symbol I% is used to indicate the neces- 
sity for an integer value). 


Section numbers found in the Explanation column refer to sections 


in the BASIC-PLUS Language Manual. 


Type Function Explanation 
Mathematical Y=ABS (X) returns the absolute value of X. 
Y+ATN (X) returns the arctangent of X, where X 
is in radians. 
Y=COS (X) returns the cosine of X, where X is 
in radians. 
Y=EXP (X) returns the value of etX, where e=2.71828. 
Y=FIX(X) returns the truncated value of X, 
SGN (X) * INT (ABS (X) ) 
Y=INT (X) returns the greatest integer in X which 
is less than or equal to X. 
Y=LOG (X) returns the natural logarithm of X, log_X. 
Y=LOG1Q@ (X) returns the common logarithm of xX, Log, gX- 
Y=PI has a constant value of 3.14159. 
Y=RND returns a random number between @ and l. 
Y=RND (X) returns a random number between g and l. 
Y=SGN (X) returns the sign function of X, a value 
of 1 preceded by the sign of X. 
Y=SIN(X) returns the sine of X, where X is in 
radians. 
Y=SQR(X) returns the square root of X. 
Y=TAN (X) returns the tangent of X, where X is in 
radians. 
Print Y¥%=POS (X%) returns the current position of the print 


head for I/O channel X, # is the user's 
Teletype. (This value is imaginary for 
disk files.) 

YS=TAB (X%) moves print head to position X in the cur- 
rent print record, or is disregarded if 
the current position is beyond X. The 
first position is counted as @. 


String Y%=ASCII (A$) returns the ASCII value of the first char- 
acter in the string A$. 
YS=CHRS (X3) returns a character string having the 


ASCII value of X. Only one character 
is generated. 

YS=CVTZS (1%) maps integer into 2-character string, see 
Section 12.5. 

YS=CVTFS (X) maps floating-point number into 4- or 8- 
character string, see Section 12.5. 

YS=CVTS$% (AS) maps first 2 characters of string A$ into 
an integer, see Section 12.5. 

Y=CVTSF (A$) maps first 4 or 8 characters of string A$ 
into a floating-point number. See 
Section 12.5. 
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Type Function 


Explanation 
: 1 
String YS=CVTS$$ (AS ,1%) converts string A$ to string yY$ 
cont'd. according to value of I%. See 


Section 12.5. 

YS=STRINGS (N1% ,N2%) 1 sreates string Y$ of length Nl and 
characters whose ASCII decimal 
value is N2. See Section 5.5. 

Y$=LEFT (AS ,N%) returns a substring of the string A$ 
from the first character to the Nth 
character (the leftmost N characters). 

YS=RIGHT (AS$._,N%) returns a substring of the string A$ 
from the Nth to the last character; 
the rightmost characters of the string 
starting with the Nth character. 

Y$=MID(A$,N1%,N2%) returns a substring of the string A$ 
starting with the Nl and being N2 
characters long (the characters 
between and including the Nl 
to N1+N2-1 characters). 

Y%=LEN (AS) returns the number of characters in the 
string A$, including trailing blanks. 

Y%=INSTR(N1%,A$S,B$) indicates a search for the substring 
B$ within the string A$ beginning at 
character position Nl. Returns a 
value 9 if BS is not in AS, and the 
character position of BS if BS is 
found to be in A$ (character posi- 
tion is measured from the start of 
the string). 


YS=SPACES (N%) indicates a string of N spaces, used 
to insert spaces within a character 
string. 

YS=NUMS (N%) indicates a string of numeric charac- 


ters representing the value of N as 
it would be output by a PRINT state- 
ment. For example: NUM$(1.999@) 
(space)1(space) and NUMS$(-1.9999) 
-l(space). 

Y=VAL (A$) computes the numeric value of the 
string of numeric characters AS. 
If A$ contains any character not 
acceptable as numeric input with 
the INPUT statement, an error re- 
sults. For example: 


VAL ("15")=15 


YS=XLATE (A$, BS) translate A$ to the new string Ys 
by means of the table string BS, 
see Section 12.7. 


1 ‘ : ‘ 
These functions are not available prior to Version 5B(RSTS/E) systems. 
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Type Function 


System YS=DATES (9%) 


YS=DATES (N%) 


YS=TIMES (93%) 


YS=TIMES (N%) 


Y=TIME (9%) 
Y=TIME (1%) 


Y=TIME (2%) 
1 

Y=TIME (3%) 
1 

Y=TIME (4%) 


yg=sTaTuUS? 


Y%=BUFSIZ (N)* 
Y$=LINE 


Y%=ERR 
Y%=ERL 


Y%=SWAPS (NS) 


Explanation 


returns the current date in the fol- 
lowing format: 


g2-Mar-71 


returns a character string correspond- 
to a calendar date as follows: 
N=(day of year)+[( (number of 
years since 1970) *1000] 


DATES(1) = "@l-dJan-79" 


DATE$ (125) = “g5-May-79" 
DATES (4125) = "95-May-74" 


returns the current time of day as a 
character string as follows: 
TIMES (9) = "05:38 PM" or "17:39 " 
returns a string corresponding to the 


time at N minutes before midnight, 
for example: 


TIMES(1) = "11:59 PM" or "23:59 " 
TIMES (1449) = "12:98 AM" or "SP: " 
TIME$(721) = "11:59 AM" or "11:59 " 


returns the clock time in seconds since 
midnight, as a floating point number. 

returns the central processor time used 
by the current job in tenths of seconds. 

returns the connect time (during which 
the user is logged into the system) 
for the current job in minutes. 

returns to Y the decimal number of 
kilo-core ticks (kct's) used by this 
job. See Section 8.8. 

returns to Y the decimal number of 
minutes of device time used by this 
job. See Section 8.8. 

returns to Y% the status of a channel 
as of the most recent OPEN statement 
executed in the program. See Section 
12.3.5. 

returns to Y% the buffer size of the 
device or file open on Channel N. 
See Section 12.3.4. 

returns to Y% the line number of the 
statement being executed at the time 
of an interrupt. See Section 4.5. 

returns value associated with the last 
encountered error if an ON ERROR GOTO 
statement appears in the program. 
See Section 8.4. 

returns the line number at which the 
last error occurred if an ON ERROR 
GOTO statement appears in the pro- 
gram. See Section 8.4.3. 

causes a byte swap operation on the 
two bytes in the integer variable N$%. 


linese functions are not available prior to Version 5B(RSTS/E) systems. 
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Type Function Explanation 


YS$=RADS (N$%) converts an integer value to a 3- 
character string and is used to con- 
vert from Radix-5ff format back to 
ASCII. See Appendix D. 


Matrix MAT Y=TRN (X) returns the transpose of the matrix xX, 
see Section 7.6.2. 
MAT Y=INV(X) returns the inverse of the matrix xX, 
see Section 7.6.2. 
Y=DET following an INV(X) function evaluation, 


the variable DET is equivalent to the 
determinant of X. 


Y%=NUM following input of a matrix, NUM contains 
the number of rows input, or, in the 
case of a dimensional matrix, the 
number of elements entered. 


Y%=NUM2 following input of a matrix, NUM2 contains 
the number of elements entered in that 
row. 

Input/Output Y%=RECOUNT returns the number of characters read 


following every input operation. 
Used primarily with non-file struc- 
tured devices. See Section 12.3.1. 


A.4 SUMMARY OF BASIC-PLUS STATEMENTS 


The following summary of statements available in the BASIC-PLUS 
language defines the general format for the statement as a line ina 
BASIC program. If more detailed information is needed, the reader is 
referred to the section(s) in the BASIC-PLUS Language Manual dealing 
with that particular statement. 


NOTE: All section numbers refer to the BASIC-PLUS Language Manual, 


In these definitions, elements in angle brackets are necessary 
elements of the statement. Elements in square brackets are necessary 
elements of which the statement may contain one. Elements in braces 
are optional elements of the statement. 


Where the term line number ({Zine number}) is shown in braces, 
this statement can be used in immediate mode. 


The various elements and their abbreviations are described below: 
variable or var Any legal BASIC variable as described in A.1l 


or Section 2.5.2. 


line number Any legal BASIC line number described in 
Section 2.2. 


expresston OXY exp Any legal BASIC expression as described in 
Section 2.5. 


message Any combination of characters. 

eonditton or gond Any logical condition as described in Sec- 
tion 3.5. 

constant Any acceptable integer constant (need not 


contain a % character). 
argument(s) Or arg Dummy variable names. 
statement Any legal BASIC-PLUS statement. 


string Any legal string constant or variable as 
described in Section 5.1. 


protectton Any legal protection code as described in 
Section 9.1. 


value(s) Any floating point, integer, or character 
string constant. 


list The legal list for that particular statement. 

dimenston(s) One or two dimensions of a matrix, the maxi- 
mum dimension(s) for that particular state- 
ment. 


BASIC-PLUS Language 


Statement Formats and Examples Manual Section 
pracement Formats and Examples oe SELON 
REM 

{line number} REM <message> 3.1 

{line number}{<statement>}!<message> 


LET 
{line 


DIM 
line 


line 


RANDOMIZE 


line 


IF-THEN, IF-GOTO 


line number 


IF-THEN-ELSE 


line 
FOR 
line 
FOR-WHILE, 
ine 
NEXT 
line 


1g REM THIS IS A COMMENT 
15 PRINT !PERFORM A CR/LF 
number} {LET}<var>{,<var>,<var>...} = <exp> 3.2 
55 LET A=4@: B=22 
69 B,C,A=4.2 !MULTIPLE ASSIGNMENT 
number DIM<var(dimeneton(s))> 3.6.2 
1g DIM A(2#), BS(5,1f), C%(45) 7.1 
number DIM #<constant>,<var(dimension(s))>=<eonstant> 11.1 
75 DIM #4, A$(199)=32,B(59,59) 11.1 
3.7.2 
number RANDOM{1IZE} 
55 RANDOMIZE 
78 RANDOM 
THEN<statement> 
IF <eond>]| THEN<line number> 3.5 
GOTO<line number> 
55 IF A?>B OR B>C THEN PRINT "NO" 
68 IF FNA(R)= B THEN 259 
95 IF L<xXt2 AND L<>g GOTO 345 
THEN<statement> 8.5 
number IF <eond>| THEN<line number> ELSE<statement> 
GOTO<line number> ELSE<line number> 
39 IF B=A THEN PRINT "EQUAL" ELSE PRINT "NOT EQUAL" 
5@ IF A>N THEN 298 ELSE PRINT A 
75 IF B==R THEN STOP ELSE 89 
number FOR <var>= <exp>TO <exp> {STEP<exp>} 3.6.1 
28 FOR I=2 TO 49 STEP 2 
55 FOR N=A TO A+R 
FOR-UNTIL WHILE 8.6 
number FOR <var> = <exp> {STEP<exp>} UNTIL | <cond> 
84 FOR I = 1 STEP 3 WHILE I<X 
74 ‘FOR N = 2 STEP 4 UNTIL N>A OR N=B 
g5 FOR B= 1 UNTIL B>1g 
3.6.1 
number NEXT <var> 
25 NEXT I 
68 NEXT N 


BASIC-PLUS Language 


Statement Formats and Examples Manual Section 
DEF, single line 3.7.3 
line number DEF FN<var>(arg) =<exp(arg)> 5.5.1 

26 DEF FNA(X,Y,2Z)=SQR(Xt2+Y¥+2+Zt2) 6.4 


DEF, multiple line 
Zine number DEF FN<var>(arg) 8.1 


line 
line 


GOTO 


line 


ON-GOTO 
line 


GOSUB 
line 


ON-GOSUB 
Line 


RETURN 
Line 


CHANGE 


{line 


OPEN 
{line 


CLOSE 
Tline 


READ 
line 


<statements> 
number FN<var>=<exp> 
number FNEND 
18 DEF FNF(M) !FACTORIAL FUNCTION 
28 IF M=l1 THEN FNF=1 ELSE FNF=M*FNF (M-1) 


39 FNEND 
3.4 
number GOTO <line number> 
198 GOTO 59 
number ON <exp> GOTO <list of line numbers> 8.2 
75 ON X GOTO 95, 159, 45, 209 
number GOSUB <line number> 3.8.1 
98 GOSUB 299 
number ON <exp> GOSUB <list of Line numbers> 8.3 
85 ON FNA(M) GOSUB 299, 258, 49%, 375 
number RETURN 3.8.2 
375 RETURN 
5.2 
<array name> ee var> 
number} CHANGE esting aay TO <aveay ae 
25 CHANGE A$ TO X 
78 CHANGE M TO R$ 
75 CHANGE B TO BS 
9.2 
° NPUT 9.2.1 
number} OPEN<s tring> {FOR( oNrerp }AS FILE <exp> 9.2.2 


{ ,RECORDSIZE<exp>}{,CLUSTERSIZE <exp>}{,MODE <exp>} 
1g OPEN "PP:" FOR OUTPUT AS FILE Bl 

20 OPEN "FOO" AS FILE 3 

39 OPEN "DT4:DATA.TR" FOR INPUT AS FILE 19 


9.3 
number} CLOSE <list of exp> 
199 CLOSE 2 
255 CLOSE 19, 4, NI 
3.3.1 
5.3 
number READ <list of vartables> 6.3 
25 READ A, BS, C%, Fl, R2, B(25) 10.1 


Statement Formats and Examples 


DATA 
line number 
399 
RESTORE 
line number 
125 
PRINT 
{Zine number} 
25 
75 
45 


PRINT USING 
Zine number} 
54 
55 
56 


INPUT 
Tline number} 
25 
55 


INPUT LINE 
line number} 


4g 
75 

NAME-AS 
{Zine number} 
455 
279 

KILL 

{line number} 
45 


ON ERROR GOTO 
tne number 


RESUME 
line number 


1999 
655 


CHAIN 
line number 
375 
562 
6 £2 


BASIC-PLUS Language 


Manual Section 


3.3.1 
DATA <list of values> 5.3 
DATA 4.3, "STRING",85,49,75.94,19 6.3 
3.3.1 
RESTORE 10.2 
RESTORE 
3.3.2 
5.4 
PRINT{ {#<exp>, }<lZist>} 6.3 
PRINT !GENERATES CR/LF 10.3 
PRINT "BEGINNING OF OUTPUT";1I,A*I 10.3.1 
PRINT #4,"OUTPUT TO DEVICE"FNM{A) +2;B;A 10.3.2 
PRINT {#<exp>, }USING <string>, <list> 10.3.3 
PRINT USING "##.##",A 


PRINT #3, USING"\\###.## \\##t+tt","A=",A,"B=",B 
PRINT #7, USING B$,A,B,C 

3.3.3 

INPUT {#<exp>,}<list> 5.3 

INPUT "TYPE YOUR NAME ",AS 10.4 

4nd 


INPUT #8, A, N, BS 


INPUT 
INPUT 
INPUT 


LINE {#<exp>,} <string> 
LINE R$ 
LINE #1, ES 


NAME 
NAME 
NAME 


<string> AS <string> 
"NONAME" AS "FILE1<48>" 
"DT4:MATRIX" AS "MATA1<48>" 


KILL 
KILL 


<string> 
"NONAME" 


ON ERROR GOTO {<Zine number>} 

ON ERROR GOTO 599 

ON ERROR GOTO !DISABLES ERROR ROUTINE 

ON ERROR GOTO @ I!DISABLES ERROR ROUTINE 


RESUME {<Zine number>} 
RESUME !OR RESUME @ ARE EQUIVALENT 
RESUME 299 


CHAIN 
CHAIN 
CHAIN 
CHAIN 


<string> {<exp>} 
"PROG2" 

"PROG3" 75 
"PROG3" A 
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Statement Formats and Examples Manual Section 
STOP 3.9 
line number STOP 
75 STOP 
END 3.9 
line number END 
545 END 
Matrix Statements 
MAT READ 7.2 
Zine number MAT READ <list of matrices> 
55 DIM A(29), B$(32), C%(15,19) 
98 MAT READ A, B$(25), C% 
MAT PRINT 7.3 
[line number} MAT PRINT{#<exp>,} <matrix name> 
1g DIM A (2g), B(15,29) 
99 MAT PRINT A; !PRINT 19*19 MATRIX, PACKED 
95 MAT PRINT B(19,5), !PRINT 19*5 MATRIX, FIVE 
{ELEMENTS PER LINE 
97 MAT PRINT #2, A; IPRINT ON OUTPUT CHANNEL 2 
MAT INPUT . 7.4 
[Zine number} MAT INPUT{#<exp>,} <list of matrices> 
19 DIM BS$(4f), F1%(35) 
29 OPEN "DT3:FOO" FOR INPUT AS FILE 3 
39 MAT INPUT #3, B4, F1% 
MAT Initialization 7.5 
ER 
{line number} MAT <matriz nane> [e0H| (dineneion(a)) 
ID. 
1g DIM B(15,18), A(1M), C8(5) 
15 MAT C% = CON {ALL ELEMENTS OF C%(I)=1 
28 MAT B = IDN(19,12) {IDENTITY MATRIX 19*19 
95 MAT B = ZER(N,M) {CLEARS AN N BY M MATRIX 
Statement Modifiers (can be used in immediate mode) 
IF 8.7.1 
<statement> IF <eondition> 
1g PRINT X IF X<>g 
UNLESS 
<statement> UNLESS <eonditton> 8.7.2 
45 PRINT A UNLESS A=9 
FOR 8.7.3 
<statement> FOR <var> = <exp> TO <exp>{STEP<ezp>} 
75 LET B$(I) = "PDP-11" FOR I = 1 TO 25 
88 READ A(I) FOR I=2 TO 8 STEP 2 
WHILE 8.7.4 


<statement> WHILE <condittion> 
1@ LET A(I) = FNX(I) WHILE I<45.5 
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Statement Formats and Examples 


BASIC-PLUS Language 
Manual Section 


UNTIL 
<statement> UNTIL <econdittion> 
115 IF B @ THEN A(I)=B UNTIL I>5 


System statements 


<line number> SLEEP <expresston> 
108 SLEEP (2f) IDISMISS JOB FOR 26 SEC. 


<line number> WAIT <expression> 
525 WAIT (A%+5) !IWAIT A%+5 SEC. FOR INPUT 


Record I/O Statements 


<line number> LSET<string var>{,<string var>}=<string> 
96 LSET BS="XYzZ" 


<Line number> RSET<string var>{,<string var>}=<string> 
256 RSET CS="67896" 


8.7.5 


12.4.3 


12.4.3 


<Line number> FIELD#<expr>,<expr>AS<string var>{,<expr>AS<string var>} 


75 FIELD#2%,18% AS AS, 28% AS BS 


<line number> GET#<expr>{,RECORD<expr>} 
188 GET#1%,RECORD 99% 


<line number> PUT#<expr>{,RECORD<expr>}{,COUNT<expr>} 
566 PUT#1%,COUNT 8f% 


<Line number> UNLOCK#<expr> 
702 UNLOCK #3% 


A-1l 


12.4.2 
12.3 


12.3 


10.5.1 


APPENDIX B 


BASIC-PLUS COMMAND SUMMARY 
Section in 
RSTS-11 


Command Explanation System User's Guide 


APPEND Used to include contents of a previously 2.4.3 
saved source program in current program. 


ASSIGN Used to reserve an I/O device for the use 2. 
of the individual issuing the command. The 2 
specified device can then be given commands 
only from the terminal which issued the ASSIGN. 

Also establishes a logical name for a device, 


establishes an account for the @ rharartar 
Sstanvsisnes an CCcount fOr cil © CliaLcavever, 


and assigns a default protection code. 


ATTACH Attaches a detached job to the current 4.1 
terminal. 


BYE Indicates to RSTS that a user wishes to leave 2.1.3 
the terminal. Closes and saves any files 
remaining open for that user. 


CAT Returns the user's file directory. Unless 2.5.2 
CATALOG another device is specified following the 

term CAT or CATALOG, the disk is the 

assumed device. 


CCONT For privileged users. Same as CONT command 2.2.9 
but detaches job from terminal. 


COMPILE Allows the user to store a compiled version 2.3.3 
of his BASIC program. The file is stored on 
disk with the current name and the extension 
-BAC. Or, a new file name can be indicated 
and the extension .BAC will still be appended. 


CONT Allows the user to continue execution of the 2.2.8 
program currently in core following the execu- 
tion of a STOP statement. 


DEASSIGN Used to release the specified device for use 2 
by others. If no particular device is speci- 2 
fied, all devices assigned to that terminal 
are released. An automatic DEASSIGN is per- 
formed when the BYE command is given. Also 
releases any logical name for a device. 


DELETE Allows the user to remove one or more lines 2.2.5 
from the program currently in core. Following 
the word DELETE the user types the line number 
of the single line to be deleted or two line 
numbers separated by a dash (-) indicating the 
first and last line of the section of code to 
be removed. Several single lines or line 
sections can be indicated by separating the 
line numbers, or line number pairs, with a 
comma. 


Section in 
RSTS-11 


Command Explanation System User's Guide 


HELLO Indicates to RSTS that a user wishes to log 233 
onto the system. Allows the user to input 4. 
project-programmer number and password. Also 
attaches a detached job to the current termi- 
nal or changes accounts without having to log 
off the system. 


1.2 
1 


KEY Used to re-enable the echo feature on the user 2.6.2 
terminal following the issue of a TAPE command. 
Enter with LINE FEED or ESCAPE key. 


LENGTH Returns the length of the user's current 2.5.1 
program in core, in 1K increments. 


List Allows the user to obtain printed listing 2.2.4 
at the user terminal of the program currently 
in core, or one or more lines of that program. 
The word LIST by itself will cause the listing 
of the entire user program. LIST followed by 
one line number will list that line; and LIST 
followed by two line numbers separated by a 
dash (-) will list the lines between and 
including the lines indicated. Several single 
lines or line sections can be indicated by 
separating the line numbers, or line number 
pairs, with a comma. 


LISTNH Same as LIST, but does not print header con- 2.2.4 
taining the program name and current date. 


LOGIN Same as HELLO 4.1 


NEW Clears the user's area in core and allows the 2.2.1 
user to input a new program from the terminal. 
A program name can be indicated following the 
word NEW or when the system requests it. 


OLD Clears the user's area in core and allows the 2.4.2 

user to.recall a saved program from a storage 

device. The user can indicate a program name 

following the word OLD or when the system 

requests it. If no device name is given, the 

file is assumed to be on the system disk. A 

device specification without a filename will 

cause a program to be read from an input-only 

device (such as high-speed reader, card reader). 


REASSIGN Transfers control of a device to another job. 2.6.5 


RENAME Causes the name of the program currently in 2.2.6 
core to be changed to the name specified after 
the word RENAME. 


REPLACE Same as SAVE, but allows the user to substitute 2.4.7 
a new program with the same name for an old 
program, erasing the old program. 


Section in 
RSTS-11 


Command Explanation System User's Guide 


RUN Allows the user to begin execution of the pro- 2.3.1 
gram currently in core. The word RUN can be 
followed by a file name in which case the 
file is loaded from the system disk, compiled, 
and run alternatively, the device and file name 
can be indicated if the file is not on the system 
disk. A device specification without a file name 
will cause a program to be read from an input 
only device (such as high-speed reader, card 
reader). 


ty 
. 
he 


RUNNH Causes execution of the program currently in Pi 
memory but header information containing the 
program name and current date is not printed. 
If a filename is used, the command is executed 
as if no filename were given. 


SAVE Causes the program currently in core to be 2.4.1 
saved on the system disk under its current 
file name with the extension .BAS. Where the 
word SAVE is followed by a file name or a 
device and a file name, the program in core 
is saved under the name given and on the device 
specified. A device specification without a 
file name will cause the program to be output 
to any output only device (line printer, high- 
speed punch). 


SCALE Sets the scale factor to a designated value 2.8 
or prints the value(s) currently in effect 
if no value is designated. 


TAPE Used to disable the echo feature on the user 2.6.1 
terminal while reading paper tape via the 
low-speed reader. 


UNSAVE The word UNSAVE is followed by the file name 2.4.6 
and, optionally, the extension of the file to 
be removed. The UNSAVE command cannot remove 
files without an extension. If no extension 
is specified, the source (.BAS) file is 
deleted. If no device is specified, the disk 
is assumed. 


Special Control Character Summary 


CTRL/C Causes the system to return to BASIC command 3.5 
mode to allow for issuing of further commands 
or editing. Echoes on terminal as C. 


CTRL/O Used as a switch to suppress/enable output of 3.7 
a program on the user terminal. Echoes as [0. 


CTRL/Q When generated by a device on which a 3.10 
CTRL/S has interrupted output, causes computer 
to resume output at the next character. 


Section in 


RSTS-11 
Command Explanation System User's Guide 
CTRL/S When generated by a device for which SCOPE 3.10 
characteristics are set, interrupts computer 
output on the device until either CTRL/Q or 
another character is generated. 
CTRL/U Deletes the current typed line, echoes as [{U 3.6 
and performs a carriage return/line feed. 
CTRL/Z Used as an end-of-file character. 3.9 
ESCape or Enters a typed line to the system, echoes on 3.2 
ALT MODE the user terminal as a $ character and does 
Key not cause a carriage return/line feed. 
LINE FEED Used to continue the current logical line on 3.3 
Key an additional physical line. Performs a 
carriage return/line feed operation. 
RETURN Enters a typed line to the system, results ina 3.1 
Key carriage return/line feed operation at the user 
terminal. 
RUBOUT Deletes the last character typed on that physi- 3.4 
Key cal line. Erased characters are shown on the 
teleprinter between back slashes. 
TAB or Performs a tabulation to the next of nine tab 3.8 


CTRL/I stops (eight spaces apart) which form the 
terminal printing line. 


CTRL/L Generates FORM FEED character and results in 
four line feed operations at the user terminal. 


APPENDIX C 


ERROR MESSAGE SUMMARY 


Wherever possible, RSTS follows an error message with the phrase 
AT LINE xxxx 


where xxxx is the line number of the statement which caused the error. 


For example: 


1g TALK 
ILLEGAL VERB AT LINE 19 
READY 


The additional message is not printed when no line number can be as- 


sociated with the error. 


TALK 
WHAT? 
READY 


An (SPR) in the description of any error message in this Appendix 
indicates an error which should never be seen by a user. If such a 
message is received, the user should document how he obtained the error 
and file a Software Performance Report with DEC, including the perti- 


nent output. 
C.1 USER RECOVERABLE ERRORS 


A (C) in the description of the error message indicates that pro- 
gram execution continues, following printing of the error message, 
if an ON ERROR GOTO statement is not present, Normally, execution 
terminates on an error condition, the error Message is printed, and 
the system prints READY. The ERR column gives the value of the ERR 


variable (see Section 8.4 in the BASIC-PLUS Language Manual). 


ERR Message Printed Meaning 
1 BAD DIRECTORY FOR DEVICE The directory of the device refer- 


enced is an unreadable format, 


ERR 


10 


Message Printed 
ILLEGAL FILE NAME 


ACCOUNT OR DEVICE IN USE 


NO ROOM FOR USER ON DEVICE 


CAN'T FIND FILE OR ACCOUNT 


NOT A VALID DEVICE 


I/O CHANNEL ALREADY OPEN 


DEVICE NOT AVAILABLE 


I/O CHANNEL NOT OPEN 


PROTECTION VIOLATION 


Meaning 


The filename specified is not accept- 
able. It contains unacceptable char- 
acters or the filename specification 
format has been violated. 


Removal or dismounting of the account 
or device cannot be done since one 
or more users are currently using it. 


Storage space allowed for the current 
user on the device specified has been 
used or the device as a whole is too 

full to accept further data. 


The file or account number specified 
was not found on the device specified. 


Attempt to use an illegal or nonexis- 
tent device specification. 


An attempt was made to open one of 
the twelve I/O channels which had 
already been opened by the program. 
(SPR) 


The device requested is currently 
reserved by another user. 


Attempt to perform I/O on one of the 
twelve channels which has not been 
previously opened in the program. 


The user was prohibited from perform- 
ing the requested operation because 
the kind of operation was illegal 
(such as input from a line printer) 
or because the user did not have the 
privileges necessary (such as delet- 
ing a protected file). 


Attempt to perform input beyond the end 

of a data file; or a BASIC source file is 
called into memory and is found to contain 
no END statement. 


11 END OF FILE ON DEVICE 


12 FATAL SYSTEM I/O FAILURE An I/O error has occurred on the sys- 
tem level. The user has no guarantee 
that the last operation has been 
performed. (SPR) 

13 USER DATA ERROR ON DEVICE One or more characters may have been 
transmitted incorrectly due to a par- 
ity error, bad punch combination on 

a card, or similar error. 


14 DEVICE HUNG OR WRITE LOCKED User should check hardware condition 
of device requested. Possible causes 
of this error include a line printer 
out of paper or high-speed reader 
being off-line. 

15 KEYBOARD WAIT EXHAUSTED Time requested by WAIT statement has 

been exhausted with no input received 

from the specified keyboard. 


C-2 


ERR 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


Message Printed 
NAME OR ACCOUNT NOW EXISTS 


TOO MANY OPEN FILES ON UNIT 


ILLEGAL SYS() USAGE 


DISK BLOCK IS INTERLOCKED 


PACK IDS DON'T MATCH 


DISK PACK IS NOT MOUNTED 
DISK PACK IS LOCKED OUT 
ILLEGAL CLUSTER SIZE 


DISK PACK IS PRIVATE 


DISK PACK NEEDS 'CLEANING' 


FATAL DISK PACK MOUNT ERROR 


I/O TO DETACHED KEYBOARD 


PROGRAMMABLE +C TRAP 


CORRUPTED FILE STRUCTURE 


Meaning 


An attempt was made to rename a 
file with the name of a file which 
already exists, or an attempt was 
made by the system manager to in- 
sert an account number which is 
already within the system. 


Only one open DECtape output file 
is permitted per DECtape drive. 
Only one open file per magtape 
drive is permitted. 


Illegal use of the SYS system func- 
tion. 


The requested disk block segment 
is already in use (locked) by some 
other user. 


The identification code for the 
specified disk pack does not match 
the identification code already on 
the pack. 


No disk pack is mounted on the 
specified disk drive. 


The disk pack specified is mounted 
but temporarily disabled. 


The specified cluster size is unac- 
ceptable. 


The current user does not have ac- 
cess to the specified private disk 
pack. 


Non-fatal disk mounting error; use 
the CLEAN operation in UTILTY, 
Fatal disk mounting error. Disk can- 
not be successfully mounted. 


I/O was attempted to a hung up 
dataset or to the previous, but now 
detached, console keyboard for the 
job. 


ON ERROR-GOTO subroutine was entered 
through a program trapped CTRL/C. 
See a description of the SYS system 
function. 


Fatal error in CLEAN operation. 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


40 


41 
42 


DEVICE NOT FILE STRUCTURED 


ILLEGAL BYTE COUNT FOR I/O 


NO ROOM AVAILABLE FOR FCB 


UNIBUS TIMEOUT FATAL TRAP 


RESERVED INSTRUCTION TRAP 


MEMORY MANAGEMENT VIOLATION 


SP(R6) STACK OVERFLOW 


DISK ERROR DURING SWAP 


MEMORY PARITY FAILURE 


MAGTAPE SELECT ERROR 


MAGTAPE RECORD LENGTH 
ERROR 


NO RUN-TIME SYSTEM 
VIRTUAL BUFFER TOO LARGE 


An attempt is made to access a device, 
other than a disk, DECtape, or magtape 
device, as a file-structured device. 
This error occurs, for example, when 
the user attempts to gain a directory 
listing of a non-directory device. 


The buffer size specified in the 
RECORDSIZE option of the OPEN state- 
ment or in the COUNT option of the PUT 
statement is not a multiple of the 
block size of the device being used for 
I/o. 


When the user accesses a file under 
programmed control in RSTS-11l, a sys- 
tem control structure called an FCB 
requires one small buffer and one small 
buffer is not available for the FCB. 


This hardware error occurs when an 
attempt is made to address nonexistent 
memory or an odd address using the 
PEEK function. An occurrence of this 
error message in any other case is 
cause for an SPR. 


An attempt is made to execute an 
illegal or reserved instruction or an 
FPP instruction when floating point 
hardware is not available. (SPR) 


This hardware error occurs when an 
illegal Monitor address is specified 
using the PEEK function. Generation 
of the error message in situations 
other than using PEEK is cause for an 
SPR. 


An attempt to extend the hardware 
stack beyond its legal size is 
encountered. (SPR) 


A hardware error occurs when a user's 
job is swapped into or out of memory. 
The contents of the user's job area 
are lost but the job remains logged 
into the system and is reinitialized 
to run the NONAME program. (SPR) 


A parity error was detected in the 
memory occupied by this job. 


When access to a magtape drive was 
attempted, the selected unit was 
found to be off line. 


When performing input from magtape, 
the record on magtape was found to 
be longer than the buffer designated 
to handle the record. 


Reserved. 


Virtual core buffers must be 512 
bytes long. 


ERR 


43 


44 
45 


46 


47 


48 


49 


50 


51 


52 


53 


54 


55 


56 
57 


58 


Message Printed 
VIRTUAL ARRAY NOT ON DISK 


MATRIX OR ARRAY TOO BIG 
VIRTUAL ARRAY NOT YET OPEN 


ILLEGAL I/O CHANNEL 


LINE TOO LONG 


FLOATING POINT ERROR 


ARGUMENT TOO LARGE IN EXP 


DATA FORMAT ERROR 


INTEGER ERROR 


ILLEGAL NUMBER 


ILLEGAL ARGUMENT IN LOG 


IMAGINARY SQUARE ROOTS 


SUBSCRIPT OUT OF RANGE 


CAN'T INVERT MATRIX 
OUT OF DATA 


ON STATEMENT OUT OF RANGE 


Meaning 


A non-disk device is open on the 
channel upon which the virtual 
array is referenced. 


In-core array size is too large 


An attempt was made to use a virtual 
array before opening the correspond- 
ing disk file. 


Attempt was made to open a file on 
an I/O channel outside the range of 
the integer numbers 1 to 12. 


Attempt to input a line longer than 
255 characters (which includes any 
line terminator). Buffer overflows/ 


Attempt to use a computed floating 
oint number outside the range 
1E-38|<n<|1E38| excluding zero. 

If no transfer to an error handling 

routine is made, zero is returned 

as the floating point value. (C) 


Acceptable arguments are within the 
approximate range -89<arg<+88. The 
value returned is zero. TC) 


A READ or INPUT statement detected data 
in an illegal format. For example, 
1..3 isan improperly formed number, 
1.2 is an improperly formed integer, 
and X" isan illegal string. (C) 


Attempt to use a computed integer 
outside the range -32767<n<32767. 
If no transfer to an error handling 
routine is made, zero is returned 
as the integer value. (C) 


Integer or floating point overflow 
or underflow. 


Negative or zero argument to log 
function. Value returned is the 
argument as passed to the function. 
(C) 


Attempt to take square root of a 
number less than zero. The value 
returned is the square root of the 
absolute value of the argument. (C) 


Attempt to reference an array ele- 
ment beyond the number of elements 
created for the array when it was 

dimensioned, 


Attempt to invert a singular or 
nearly singular matrix. 


The DATA list was exhausted and a 
READ requested additional data, 


The index value in an ON-GOTO or 
ON-GOSUB statement is less than 
one or greater than the number of 
line numbers in the list. 


ERR Message Printed 


59 NOT ENOUGH DATA IN RECORD 
60 INTEGER OVERFLOW, 


FOR LOOP 


61 DIVISION BY 9g 


C.2 NON-RECOVERABLE ERRORS 


Message Printed 
ARGUMENTS DON'T MATCH 


BAD LINE NUMBER PAIR 


BAD NUMBER IN PRINT-USING 


CAN'T COMPILE STATEMENT 


CAN'T CONTINUE 


CATASTROPHIC ERROR 


DATA TYPE ERROR 


DEF WITHOUT FNEND 


END OF STATEMENT NOT SEEN 


EXECUTE ONLY FILE 


Meaning 


An INPUT statement did not find 
enough data in one line to satisfy 
all the specified variables. 


The integer index in a FOR loop 
attempted to go beyond 32766 or 
below -32766. 


Attempt by the user program to 
divide some quantity by zero. If 
no transfer is made to an error 
handler routine, a @ is returned 
as the result, (C) 


Meaning 


Arguments in a function call do not 
match, in number or in type, the 
arguments defined for the function. 


Line numbers specified in a LIST or 
DELETE command were formatted incor- 
rectly. 


Format specified in the PRINT-USING 
string cannot be used to print one 
or more values. 


Program was stopped or ended ata 
spot from which execution cannot be 
resumed. 


The user program data structures are 
destroyed. This normally indicates 

a BASIC-PLUS malfunction and, if re- 
producible, should be reported to DEC 
on a Software Performance Report form. 
(SPR) 


Incorrect usage of floating-point, 
integer, or character string format 
variable or constant where some other 
data type was necessary. 


A second DEF statement was encoun- 
tered in the processing of a user 
function without an FNEND statement 
terminating the first user function 
definition. 


Statement contains too many elements 
to be processed correctly. 


Attempt was made to add, delete or 
list a statement in a compiled (.BAC) 
format file. 


C-6 


Message Printed 


EXPRESSION TOO COMPLICATED 


FIELD OVERFLOWS BUFFER 


FILE EXISTS-RENAME/REPLACE 


FNEND WITHOUT DEF 


FNEND WITHOUT FUNCTION CALL 


FOR WITHOUT NEXT 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


CONDITIONAL CLAUSE 


DEF NESTING 


DUMMY VARIABLE 


EXPRESSION 


FIELD VARIABLE 


FN REDEFINITION 


FUNCTION NAME 


Meaning 


This error usually occurs when 
parentheses have been nested too 
deeply. The depth allowable is 
dependent on the individual expres- 
sion. 


Attempt to use FIELD to allocate 
more space than exists in the speci- 
fied buffer. 


A file of the name specified in a 
SAVE command already exists. In 
order to save the current program 
under the name specified, use the 
REPLACE command. 

An FNEND statement was encountered 
in the user program without a pre- 
vious DEF statement being seen. 


A FNEND statement was encountered 
in the user program without a pre- 
vious function call having been 
executed. Function has been placed 
incorrectly among executable state- 
ments or an extra FNEND statement 
has been found. 


A FOR statement was encountered in 
the user program without a corre- 
sponding NEXT statement to terminate 
the loop. 


Incorrectly formatted condition ex- 
pression. 


The range of one function definition 
crosses the range of another func- 
tion definition. 


One of the variables in the dummy 
variable list of a user-defined 
function is not a legal variable 
name. 


Double operators, missing operators, 
mismatched parentheses, or some 
similar error has been found in an 
expression. 


The FIELD variable specified is un- 
acceptable. 


Attempt was made to redefine a user 
function. 


Attempt was made to define a func- 
tion with a function name not sub- 
scribing to the established format. 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


ILLEGAL 


Message Printed 
IF STATEMENT 


IN IMMEDIATE MODE 


LINE NUMBER(S) 


MAGTAPE() USAGE 


MODE MIXING 


STATEMENT 


SYMBOL 


VERB 


INCONSISTENT FUNCTION USAGE 


INCONSISTENT SUBSCRIPT USE 


K OF CORE USED 


LITERAL 


STRING NEEDED 


MATRIX DIMENSION ERROR 


MATRIX OR ARRAY WITHOUT DIM 


MAXIMUM CORE EXCEEDED 


MISSING SPECIAL FEATURE 


Meaning 
Incorrectly formatted IF statement. 


User issued a statement for execu- 
tion in immediate mode which can 
only be performed as part of a pro- 
gram, 


Line number reference outside the 
range 1<n<32767, 


Improper use of the MAGTAPE function. 


String and numeric operations cannot 
be mixed. 


Attempt was made to execute a state- 
ment that did not compile without 
errors. 


An unrecognizable character was en- 
countered. For example, a line con- 
sisting of a # character. 


The BASIC verb portion of the state- 
ment cannot be recognized. 


A function is being redefined in a 
Manner inconsistent in the number or 
type of arguments with one or more 
calls to that function existing in 
the program. 


A subscripted variable is being used 
with a different number of dimensions 
from the number with which it was 
originally defined. 


Message printed by LENGTH command, 
preceded by the appropriate number 
describing the user program currently 
in core to the nearest 1K. 


A variable name was used where a 
numeric or character string was 
necessary. 


Attempt was made to dimension a 
matrix to more than two dimensions, 
or an error was made in the syntax 
of a DIM statement. 


A matrix or array element was ref- 
erenced beyond the range of an 
implicitly dimensioned matrix. 


User program grew to be too large 
to run or compile in the area of 
core assigned to each user at the 
given installation. 


User program employs a BASIC-PLUS 
feature not present on the given 
installation. 


Message Printed 


MODIFIER ERROR 


NEXT WITHOUT FOR 


NO LOGINS 


NOT A RANDOM ACCESS DEVICE 


NOT ENOUGH AVAILABLE CORE 


NUMBER IS NEEDED 
1 OR 2 DIMENSIONS ONLY 
ON STATEMENT NEEDS GOTO 


PLEASE SAY HELLO 


PLEASE USE THE RUN COMMAND 


PRINT-USING BUFFER OVERFLOW 


PRINT-USING FORMAT ERROR 


PROGRAM LOST-SORRY 


REDIMENSIONED ARRAY 


RESUME AND NO ERROR 


Meaning 


Attempt to use one of the statement 
modifiers (FOR, WHILE, UNTIL, IF, 
or UNLESS) incorrectly. 


A NEXT statement was encountered in 
the user program without a previous 
FOR statement having been seen. 


Message printed if the system is 
full and cannot accept additional 
users or if further logins are dis- 
abled by the system manager. 


Attempt to perform random access I/O 
to a non-random access device. 


The already compiled user program is 
too large to run in the area of core 
assigned to each user at the given 
installation. 


A character string or variable name 
was used where a number was necessary. 


Attempt was made to dimension a matrix 
to more than two dimensions. 


A statement beginning with ON does 
not contain a GOTO or GOSUB clause. 


User not logged into the system has 
typed something other than a legal, 
logged-out command to the system, 


A transfer of control (as in a GOTO, 
GOSUB or IF-GOTO statement) cannot 
be performed from immediate mode. 


Format specified contains a field too 
large to be manipulated by the PRINT- 
USING statement. 


An error was made in the construction 
of the string used to supply the out- 
put format in a PRINT-USING statement. 


A fatal system error has occurred 
which caused the user program to be 
lost. 


Usage of an array or matrix within 
the user program has caused BASIC- 
PLUS to redimension the array im- 
plicitly. 


A RESUME statement was encountered 
where no error had occurred to cause 
a transfer into an error handling 
routine via the ON ERROR-GOTO state- 
ment. 


Cc-9 


Message Printed 
RETURN WITHOUT GOSUB 


SCALE FACTOR INTERLOCK 


STATEMENT NOT FOUND 


STOP 


STRING IS NEEDED 


SYNTAX ERROR 


TEXT TRUNCATED 


TOO FEW ARGUMENTS 


TOO MANY ARGUMENTS 


UNDEFINED FUNCTION CALLED 


WHAT? 


WRONG MATH PACKAGE 


Meaning 


RETURN statement encountered in the 
user program without a previous 
GOSUB statement having been executed. 


An attempt was made to execute a 
program or source statement with 

the current scale factor. The 
program executes but the system 
uses the scale factor of the program 
in memory. Use REPLACE and OLD 

or recompile the program to 

execute with the current scale 
factor. 


Reference is made within the program 
to a line number which is not within 
the program. 


STOP statement was executed. The 
user can usually continue program 
execution by typing CONT and the 
RETURN key. 


A number or variable name was used 
where a character string was neces- 
sary. 


BASIC-PLUS statement was incorrectly 
formatted. 


No BASIC-PLUS statement can be more 
than 255 characters long. 


The function has been called with 
a number of arguments not equal to 
the number defined for the function. 


A user~defined function may have up 
to five arguments. 


BASIC-PLUS interpreted some state- 
ment component as a function call 
for which there is no defined func- 
tion (system or user). 


Command or immediate mode statement 
entered to BASIC-PLUS could not be 
processed. Illegal verb or improper 
format error most likely. 


Program was compiled with an incom- 
patible version of RSTS. Program 
source must be recompiled. 


C.3 SYSTEM IDENTIFICATION MESSAGE 


ERR code @ is associated with the system installation name for 


use by the system programs. 


Cc-10 


APPENDIX D 
BASIC-PLUS CHARACTER SET 


D.1 BASIC-PLUS CHARACTER SET 
User program statements are composed of individual characters. 
Allowable characters come from the following character set: 


A through Z Space 
g through 9 Tab 


and the following special symbols and keys: 


Key Use and Section in BASIC-PLUS Language Manual 
$ Used in specifying string variables (Section 5.1), or as the 
System Library file designator (RSTS-1l System User's Guide). 

% Used in specifying integer variables (Section 6.1). 


Also denotes account [1,4] (Section 9.1.1). 


yon Used to delimit string constants, i.e., text strings 
(Section 5.1). 


Begins comment part of a line (Section 3.1). 
Also denotes account [1,3] (Section 9.1.1). 


Separates multiple statements on one line (Section 2.3.1). 


\ Separates multiple statements on one line as the colon(:) 
also does. 


# Denotes a device or file # name, or is used as an output 
format effector (Chapter 7 and Section 10.3.4). 
Also denotes account number using current project number with 
a programmer number of g (Section 9.1.1). 


' Output format effector and list terminator (Section 3.3). 
; Output format effector (Section 3.3). 
& Denotes account [1,5] (Section 9.1.1). 
@ Denotes the assignable account (Section 9.1.1). 
LINE When used at the end of a line, indicates that the current 
FEED statement is continued on the next line (Section 2.3.2). 
Q Used to group arguments in an arithmetic expression (Sec- 
tion 2.5).Also may be used to group project-programmer number. 
{] Used to group project-programmer number. 
<> Used to delimit file protection codes. 
a 7 Arithmetic operators (Section 2.5.3). 


= Replacement operator (Section 3.2). 
Logical equivalence operator (Section 2.5.4). 


< Logical "less than" operator (Section 2.5.4). 


Vv 


Logical “greater than" operator (Section 2.5.4). 


Logical "approximately equal to" operator (Section 2.5.4). 


D.2 ASCII CHARACTER CODES 


ASCII 
Char- RSTS 
Value acter Usage 


ASCII 
Decimal Char- RSTS 
Value acter 


ASCII 
Decimal Char- RSTS 
Value acter Usage 


NUL FILL character 
COMMA 


f~ 
cs 


CTRL/C 


Backslash 


o 
oO 
HF ONK KES 


BELL 
94 or + 
95 or + 
Grave accent 


HORIZONTAL TAB 
1g LF LINE FEED 

li VT VERTICAL TAB 
12 FF FORM FEED 
CARRIAGE RETURN 


uw 
N 
es WODAIRMNAWHRERAN: 


CTRL/O 


Vertical Line 
APOSTROPHE 


a 
Be 
Be 

er NAM K EGS THNAMQDBOBSSrPAUrE Ta moandaees| 


126 Tilde 
127 DEL RUBOUT 


LALTMODE (ASCII 125) or PREFIX (ASCII 126) keys which appear on some terminals are 
translated internally into ESCAPE. 


0.3 CARD CODES 


GCANDWDOVOBZ EY AGHRMOMAONOM YP AvVV I A~ 


The RSTS card driver can be configured for one of three different 
punched card codes. These are: DEC#29 codes, DEC#@26 codes and 1491 
(EBCDIC) codes. The RSTS-11 DEC#29 and DEC#26 codes are the same as 
the DOS-11 card codes. The particular set of codes used on the system 
is determined by the system manager. In all cases, the end-of-file 
(EOF) card must contain a 12-11-g-1 punch or a 12-11~-§-1-6-7-8-9 punch 
in column 9g. 


CHARACTER — ASCII, , DECB29 DECI26 1401 CHARACTER ASCII,,  DEC#29 DECH26 1481 


+ EMR AR MMA Fee 


~ 


WDAHDUPWNHPODWAUAPW oH 
WDMYIHUBWNHNrRPUDMDNADUMBWNHH 


1 
2 
3 
4 
5 
6 
7 
8 
9 
1 
2 
3 
4 
5 
6 
7 
8 
9 


“OMNI HUSPWNHEBRN! 
OMIA U Sf WNH 


ui 
WON AUS WN 


OarNAU EWN 


PNEH 
RQ OM 
Ke 


nN 
foe) 
wm 


a em) 
Fee YF ONK KX SGCHNDWOVOZ SYP AYUHTOAAHACAWPreae 


DOr DH RAAQRKRAQAQNQ 


wu Vv i Awe 
ro 
Ls) 

an 


BMOMORPFrFPOUDWAIHRUAWNE BD 
[ees] 


REFPArFRQVBVRVAW 


EOF is 12-11-8-1 punch or a 12-11-9-1-6-7-8-9 punch. 


D.4 RADIX-5@ CHARACTER SET 


Radix-59 

Character ASCII Octal Equivalent Equivalent 
space 4g 

A-Z 1f1 - 132 1 - 32 

$ 44 33 

4 56 34 
unused 35 

g-9 68 - 71 36 - 47 


The maximum Radix-5#f value is, thus, 
47*59° + 47*59 + 47 = 174777 


The following table provides a convenient means of translating 
between the ASCII character set and its Radix-5f equivalents. For 
example, given the ASCII string X2B, the Radix-5@ equivalent is 
(arithmetic is performed in octal): 


X = 113999 
2 = $9249 
B= $999G2 
X2B = 115492 


Radix-5@ Character/Position Table 


Single Char. 
or Second Third 
First Char. Character Character 


A GB3100 A LLLI59 A POOP 
B £66266 B 666126 B 666662 
Cc 611366 Cc 666176 Cc £66063 
D 614486 D 666246 D DO6664 
E 617566 E £66316 E O660665 
F 622666 F 666368 F 660666 
G 625768 G 666436 G BO6067 
H 631866 H 666566 H 660016 
I 634166 I 666556 I 066011 
J 637268 J 666626 J O06G12 
K 642366 K 666676 K 606613 
ie 645406 L 666746 L 666614 
M O505088 M 661610 M BO6C15 
N 253668 N 661666 N 66616 
) 656768 fe) 661136 fe) 666617 
P 262666 P 661268 P £66828 
Q 665166 Q 661256 Q £66621 
R 676268 R 661328 R 666822 
Ss 673366 Ss 661376 s O£06623 
T 076406 T 661446 T O6OS24 
U 181566 U 661518 U 666625 
V 184608 V 661568 V 006626 
Ww 167766 Ww 661636 Ww O62627 
x 113008 x 601766 xX 666636 
Y 11616¢ Y 661756 Y 668831 
Zz 121266 Z 82626 Zz 666832 
$ 124368 $ 282676 $ 269033 
: 127468 : 062148 : G60034 
unused 1325668 unused £2219 unused £6635 
g 135666 g 662268 g $866 36 
1 149786 1 062336 1 066637 
2 144928 2 662466 2 666649 
3 1471628 3 062458 3 606841 
4 152288 4 662526 4 $66642 
5 155368 5 662576 5 £66843 
6 166408 6 662648 6 668044 
7 163568 7 662718 7 $66845 
8 1666008 8 002768 8 688G46 
9 1717608 9 093638 9 SO6S47 
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ACCESS DENIED message, 4-6 
Access, disk, 2-31 
identification label, 2-31 

/ACC:n switch in SCOBOL command, 
4-104 

Account [1,2], 2-22 

Account, cancelling logical name, 
2-31 

Accounting, system, 4-51 

Account in $JOB command, 4-94 

Account listing, 2-25 

Account, logical assignment of, 
2-30, 2-31 

Account number 
programmer number) 

ACCOUNT OR DEVICE IN USE error 
message, 2-29, 4-121 

Account, system operator, 

Accounts, changing, 4-11 

Accounts, restructuring, 4-26 

/AFTER:hh:mm option in QUE, 4-77 

ALREADY EXISTS message in BACKUP, 
4-65 

ALT character, 4-44 

/A/L:device option in BACKUP, 


4-18 


4-64 

/A/L:filename.ext option in 
BACKUP, 4-64 

ANSI, 4-19 

ANSI magtape files, processing, 
4-146 


labeling default, 2-33 
zeroing, 4-140 
/ANSI option in UMOUNT, 4-121 
A NULL FILE?? message, 4-126 
7A option in BACKUP, 4-64, 4-69 
APPEND command, 2-20 
Appending to a disk file, 4-140 
Arithmetic feature, scaled, 2-34 
AS, 4-19 
ASCII character codes, D-2 
ASCII character set, 1968, 
terminals with, 4-44 
ASCII type of transfer, 4-28 
ASSIGN command, 2-27 
Assigned devices determining, 4-18 
ASR-33 teletype, 5-1 
aK KR, 4-19 
ATTACH command, 4-6, 
Attaching a job, 4-8 
ATTACHING TO JOB x message, 
4-11 
ATTACH TO query, 
ATT command, 4-6, 
ATTN key, 5-27 
ATTN key, 2741, 
lower case, 5-28 
upper case, 5-28 


4-8 
4-8, 


4-10 
4-8 


-BAC extension, 2-16 
-BAC file type in BATCH, 4-91 
BACKDK system program, 4-59 
Backslash (\) character, 4-36 
Backslash (\) character as RUBOUT 
echo, 3-2 
BACKUP system program, 4-59 
command specification, 4-61 
date of creation retention, 4-70 
date of last access retention, 
4-70 
DECtape characteristics, 4-65 
detaching a job in, 4-70 
disk characteristics, 4-65 
input file elements, 4-62 
inspect feature in, 4-68 
listing a directory, 4-69 
magtape characteristics, 4-63 
magtape continuation, 4-68 
options, see options in BACKUP 
recalling files from DECtape, 
4-67 
replacing files in, 4-68 
running, 4-60 
superseding files, 4-68 
terminating, 4-60 
system disk transfer, 4-70 
verifying files, 4-70 
BAS extension, 2-17 
BAS file type in BATCH, 4-91 
SBASIC command, 4-95 
$BASIC command, source statements 
in, 4-95 
BASIC-PLUS character set, D-l 
BASIC-PLUS command summary, B-l 
BASIC-PLUS language summary, A-1 
BASIC-PLUS program (see Program) 


BASIC-PLUS statements, summary 
of, A-6 

/BASIC switch in $BASIC command, 
A-95 


BATCH commands, 
abbreviations in, 4-88 
blanks in, 4-88 
colon (;) in, 4-92 
comments, 4-89 
concatenation in, 4-97 
continuation of, 4-87 
file specification defaults, 

4-92 
listing of, 4-93 
specification fields, 4-88 
standard file types, 4-91 
syntax rules, 4-89 
utility functions, 4-96 

BATCH job, 
default time, 4-94 
priority, 4-94 
processing, 4-109 
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BATCH job (cont.), 
queuing, 4-109 
renaming, 4-93 
terminating, 4-94 
Batch stream, 4-87 
BATCH system program, 4-87 
CCL commands in, 4-94 
command fields, 4-87 
comment fields, 4-87 
control language, 4-87 
creating a file under, 4-99 
end of data in, 4-100 
error procedures, 4-111 
listing directories in, 4-98 
listing files in, 4-98 
logical assignments in, 4-102 
negating a switch, 4-92 
NO in switch, 4-92 
operating procedures, 4-109 
printing at control terminal, 
4-100 
running COBOL, 4-104 
running system programs, 4-100 
source data in, 4-100 
specification field, 4-86, 4-87 
SPOOL program under, 4-98 
volume identification, 4-102 
Baud rate, 4-37 
BCD keyboard, 5-33 
Big PIP, see PIP (16K) 
Binary file option in QUE, 4-78 
Binary files, transferring, 4-29 
BKSP key, 2741, 
lower case, 5-28 
upper case, 5-28 
Block by block transfer, 4-29 
/BL:n option in PIP (8K and 16K), 
4-24, 4-29, 4-30, 4-31, 4-147 
/BLOCK option in PIP (16K), 4-141 
Block size, 4-30 
Blocks, number of free disk, 4-18 
/B option, 
in BACKUP, 4-70, 4-71 
in QUE, 4-78 
in SYSTAT, 4-16 
Brace (}) character, 4-36 
Bracket characters, 2741, 
[ and ], 5-29 
BRief directory, 4-27 
/BR option in PIP (8K and 16K), 
4-27 
Buffers, number of free, 4-18 
Buffer status, 4-18 
BYE command, 2-3, 4-13 


CALL 360/BASIC keyboard, 5-34 

CAN'T CONTINUE message, 2-13 

CAN'T FIND FILE OR ACCOUNT 
message, 4-25 

Card codes, D-2 


Card reader, CR11, 5-6 
Carriage return/line feed 
operation, 3-1 
CATALOG command, 2-24 
CAT command, 2-24 
Cathode ray tube (CRT) display, 
5-21 
CBL file type in BATCH, 4-91 
CCL (Concise Command Language), 
4-2 
commands, 4-2 
table of, 4-2 
CCL command, 
COBOL, see COBOL 
CREATE as, 4-56 
DIR as, 4-113, 4-116 
DISMOUNT as, 4-121 
EDIT as, 4-56 
MOUNT as, 4-119 
PIP as a, 4-31 
QUE as, 4-85 
SET as, 4-47 
SORT, see SORT11 
SYS as, 4-19 
CCL commands in BATCH, 4-94 
/CCL switch in $JOB command, 4-94 
CCONT command, 2-13 
/C:dd-mmm-yy option in BACKUP, 
4-64, 4-70 
Chaining, running QUE by, 4-82 
CHAIN statement, 2-15 
Changing accounts, 4-11 
Changing default protection code, 
2-32 
Changing file name, 4-23 
Changing magtape labeling default, 
2-33 
Changing name, 2-21 
Changing program name, 2-11 
Changing protection of a program, 
2-21, 4-23, 4-144 
Character, ALT, 4-44 
Character, asterisk (*), 
in BATCH commands, 4-88 
in SDIRECTORY command, 4-98 
in EDIT, 4-55 
in PIP (16K), 4-136 
Character, backslash, 
as RUBOUT echo, 3-2 
Character, blank, in BATCH 
commands, 4-88 
Character, brace (}), 4-36 
Character codes, ASCII, D-2 
Character, colon (:), 
in BATCH commands, 4-91 
in logical names, 2-30 
with pack label, 2-31 
Character combination, control, 
4-38 
Character, comma (,), 
in DELETE command, 2-11 
in LIST command, 2-9 
in LOGIN program, 4-6 
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Character, commercial at (@), Cluster size of UFD, 4-51 


as logically assigned account, -CMD extension in PIP (16K), 4-149 
2-30 /CL:n option in PIP (8K and 16K), 
in PIP (16K) program, 4-148 4-24, 4-30 
Character, /Cin option in QUE, 4-78 
control (special), 3-1 SCOBOL command, 4-104 
Character, dash (-), COBOL program, 
in BATCH commands, 4-87 running by BATCH, 4-105 
in DELETE command, 2-10 running on-line, see PDP-11 
in LIST command, 2-9 COBOL User's Guide 
Character, DEL, 4-36 COBOL program load map, 4-104 
Character deletion, 3-1 /COBOL switch in S$COBOL command, 
Character, dollar sign (S$) 4-105 
as ESC echo, 3-1 Codes, 2741, 
in BATCH commands, 4-88 changing, 5-29 
in system commands, 2-22 Combination, control character, 
Character, double quote ("), 4-38 
in BATCH commands, 4-88 Command, 
in NAME AS command, 2-21 in BACKUP, 4-61 
Character, equals (=), in BATCH, 4-88, 4-93 
in BATCH commands, 4-92 in EDIT, 4-57, 4-58 
in QUE, 4-76 in PIP (8K), 4-21 
Character, ESC, 4-36, 4-38, 4-44 Command in QUE, 
Character, exclamation (!), general format, 4-76 
in BATCH commands, 4-87 table of, 4-75 
Character, FF, 4-34 Command, in TTYSET (RSTS) 
Character, number sign (#), table of, 4-40, 4-41 
in EDIT, 4-55 Command, 
in LOGIN, 2-1 in TTYSET RSTS/E, 4-34, 4-35, 
Character, plus (+), in BATCH 4-36, 4-37, 4-38, 4-39 
commands, 4-97 Command, macro, 
Character/position table, definition, 4-41 
RADIX-50, D-5 Command summary, BASIC-PLUS, B-l 
Character, PREFIX, 4-44 Command system, 
Character, question mark (?), APPEND, 2-20 
in BATCH, 4-111 ASSIGN, 2-27 
in LIST printout, 2-10 ATT, 4-8 
in LOGOUT, 4-13 ATTACH, 4-8 
in PIP (16K), 4-136 BYE, 2-3, 4-13 
Character, RUBOUT, 4-36 CAT, 2-24 
Character, slash (/), CATALOG, 2-24 
in BATCH, 4-92 CCONT, 2-13 
in LOGIN, 2-3 COMPILE, 2-16 
Character set, ASCII 1968, CONT, 2-12 
terminals with, 4-44 DEASSIGN, 2-28, 2-30, 2-31 
Character set, BASIC-PLUS, D-1 DELETE, 2-10 
Character set, RADIX-50, D-4 HELLO, 2-1, 2-6, 4-6, 4-9 
Character summary, control, B-3 I, 4-6 
Character, TAB, 3-4 KEY, 2-26 
Character, tilde (~), 4-36 LENGTH, 2~24 
Character, VT, 4-34 LIST, 2-9, 2-10 
Character, LISTNH, 2-10 
XOFF, 4-37 LOG, 4-6 
XON, 4-37 LOGIN, 4-6 
Characters, NEW, 2-6 
lower case, 4-34 OLD, 2-18 
requiring fills, 4-46 REASSIGN, 2-28 
translation of, 4-44, 4-45 RENAME, 2-11 
unwanted, discarding, 4-29 REPLACE, 2-23 
Clearing memory, 2-7 RUN, 2-13 
Cluster size determination, pack, RUNNH, 2-13 
4-18 SAVE, 2-17 
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Command system (cont.), 
SCALE, 2-34 
TAPE, 2-25 
UNSAVE, 2-25 
Commands at a logged out terminal, 
2-5 
Commands, logged-out, 2-6 
Comments, BATCH command, 4-89 
Comparing files, 4-123 
COMPILE command, 2-16 
Compiled file, 2-17 
default protection, 2-17 
version, 2-16 
Compiling a program, 2-16 
Computing time used, 4-51 
Concise Command Language, 
CCL) 
CONFIRM: message, 2-3, 4-13 
CONFIRM: Responses, 2-4, 4-13 
Connect time used, terminal, 
CONT command, 2-12 
Contiguous transfer, 4-30 
Continue command line option, 
in PIP, 4-150 
in QUE, 4-78 
Continuing a logical line, 3-1 
Continuing a program, 2-12 
Control character combination, 
4-38 
Control characters, 4-45 
Control characters requiring fills, 
4-46 ‘ 
Control character summary, B-3 
Controls, line printer, 5-9, 5-10 
Copies option in QUE, 4-78 
SCOPY command, 4-96, 4-97 
COPY system program, 4-131 
Correspondence code, keyboard, 5-31 
/CO option in PIP (8K and 16K), 
4-24, 4-29 
/CO:T option in PIP (8K and 16K), 
4-24, 4-30 
CR, 4-19 
CREATE as a CCL command, 4-56 
SCREATE command, 4-99 
Creating a file under BATCH, 4-99 
Creating a program, 2-6 
Creating requests for spooling 
jobs, 4-73 
Creation date, 2-24 
CR11 card reader, 5-6 
CRT display (cathode ray tube), 


(see 


4-51 


4-35, 5-21 

-CTL file type in BATCH, 4-91 
CTRL/C combination, 2-12, 3-2 
CTRL/I combination, 3-4 
CTRL/L combination, B-4 
-CTRL/O combination, 2-12, 3-3 
CTRL/Q combination, 3-4, 4-37 
CTRL/S combination, 3-4, 4-37 
CTRL/U combination, 2-8, 3-2 
CTRL/Z combination, 3-4 


CTRL/Z combination in PIP 8K, 
4-21 

CTRL/Z combination in TTYSET, 
4-33 

Current account, determining, 4-9 

Current system date, 4-6 

/CVF switch in SCOBOL command, 
4-104 


Dash (-) character, 
in BATCH commands, 4-87 
in DELETE command, 2-10 
in LIST command, 2-9 
SDATA command, 4-100 
DATA division map, 4-104 
Date of creation, file, 2-24 
Date of creation retention in 
BACKUP, 4-70 
Date of last access, file, 2-24 
Date of last access retention in 
BACKUP, 4-70 
-DAT file type in BATCH, 4-91 
/D:dd-mmm-yy option in BACKUP, 
4-64, 4-70 
DEASSIGN command, 2-28 
DEASSIGN command with logical 
account, 2-31 
DEASSIGN command with logical 
name, 2-30 
DE, defer in BATCH, 4-101 
Debugging programs, 2-12 
Decimal accuracy, 2-34 
DECtape characteristics, BACKUP, 
4-65 
DECtape controls, 5-12 
DECtape to disk transfers, 4-30 
DECtape units, 5-11 
DECtape used for backup, 4-66 
DECwriter II (LA36), 5-35 
operator controls, 5-35 
Default protection code, 
changing, 2-32 
Default time, BATCH job, 4-94 
Default values for macro command, 
4-42 
DEL character, echoing, 4-35 
DEL characters, 4-36 
SDELETE command, 4-96 
DELETE command, 
comma (,) character in, 2-11 
dash (-) character in, 2-10 
Delete commands, inspect feature 
in, 4-146 
Delete option in QUE, 4-78 
Deletion, 
all files, 4-26 
all lines, 2-11 
character, 3-1 
files, 4-14, 4-25, 4-145 
line, 3-2 
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Deletion (cont.), 
lines, 2-10 
program, 2-23 
in memory, 2-7 
DEL key, 2-8 
Density and parity settings, 
mMagtape, 4-133 
/DENSITY option in COPY, 4-133 
/DE option in PIP (8K), 425 
/DE option, writing zeroes with, 
4-140 
DET, 4-19 
Detached indicator, 4-19 
Detached job, 4-5 
attaching a, 4-10 
Detaching a job, 2-13 
Detaching a job in BACKUP, 4-70 
Detaching a program, 2-13 
/DET option, 
in BACKUP, 4-70, 4-71 
in SYSTAT, 4-16 
Device, 
cancelling logical name, 2-30 
copying volumes of a similar, 
4-131 
determining assigned, 4-18 
directory listing, 2-25 
logical names for, 2-28 
releasing a, 2-28 
reserving a, 2-27 
specifications, 2-27 
status information, 4-18 
time used, 4-51 
transferring, control of, 2-28 
time used, 4-51 
verifying, 4-132 
DEVICE HUNG OR WRITE LOCKED error, 
4-120 
DEVICE NOT AVAILABLE message, 
DF, 4-19 
DH BURST n command, 4-38 
/DI option in PIP (8K and 16K), 
4-27 
DIR as a CCL command, 4-113, 
DIRECT.HLP system file, 4-115 
SDIRECTORY command in BATCH, 4-98 
asterisk (*) character in, 4-98 
/DIRECTORY switch in, 4-98 
Directory listing, 2-25 
commands in PIP (16K), 
disk, 2-24 
option in BACKUP, 4-69 
options in PIP (8K), 4-27 
using DIRECT, 4-113 
DIRECT system program, 4-113 
default file specifications, 
4-113 
error messages, 4-117 
output file in, 4-115 
DIR file type in BATCH, 4-91 
Disable terminal echo, 2-25 


2-27 


4-116 


4-142 


Discarding unwanted characters, 


4-29 
Disk, 
access by pack id, 2-31 
blocks, 
free, 4-18, 4-49 


used, 4-49, 4-51 
characteristics in BACKUP, 4-65 
hardware error count, 4-18 
mounting a, 4-119 
number of mounted, 
quota, 

determining, 4-49, 4-51 

exceeded at logout, 2-5, 4-14 
reading a DOS, 4-141 
Status information, 

Disk file, 
appending to, 4-140 
pre-extending, 4-140 
DISK IS ALREADY MOUNTED, 
4-120 
DISK PACK IS PRIVATE error message, 
4-119 
Disk pack to preserve files, 
private, 4-65 
Disk to DECtape transfers, 4-29 
DISMOUNT as a CCL command, 4-121 
SDISMOUNT command in BATCH, 4-103 
/WAIT switch in, 4-103 
/DI:S option in PIP (8K and 16K), 
4-27 
Display, CRT, 4-35 
Dollar sign ($) character, 
as ESC echo, 3-1 
in BATCH commands, 4-88 
in system commands, 2-22 
/D option, 
in QUE, 4-78 
in SYSTAT, 4-16 
DOS, 4-19 
DOS disk reading, 4-141 
DOS labeling, 2-33 
/DOS option, 
in MOUNT, 4-120 
in PIP (16K), 4-141, 4-142 
Double quote (") character in 
BATCH command, 4-88 
DT, 4-19 
DX, 4-19 


4-18 


4-18 


error, 


EBCD keyboard, 5-32 
Echo, 
DEL character, 
disabling, 2-25 
enabling, 2-26 
lower case characters, 4-36 
EDIT as a CCL command, 4-56 
EDIT commands summary, 4-57, 4-58 
Editing programs, 2-8 


4-35 
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Editing text, 4-55 

EDITnn.TMP, 4-55 

EDIT system program, 4-55 

Embedded forms control, 4-77 

End of data in BATCH, 4-100 

END OF FILE ON DEVICE message, 

SEOD command, 4-100 

SEOJ command, 4-94 

Equals (=) character in QUE, 4-76 

Equals (=) character, BATCH 
command switch, 4-92 

Error count, disk hardware, 4-18 

ERROR IN MOUNT - ILLEGAL DEVICE 


3-4 


message, 4-121 

ERROR IN MOUNT - SYNTAX ERROR 
message, 4-121 

ERROR IN MOUNT - <text> message, 
4-120 

7ERR:n switch in SCOBOL command, 
4-104 

Error messages and codes in QUE, 
4-83, 4-84 


Error messages in DIRECT, 4-117 

Error messages, TTYSET, 4-43 

Error message summary, C-1l 

Error procedures, BATCH program, 
4-111 

Error severity in $COBOL command, 
4-104 

ERROR UNLOCKING MOUNTED PACK - 
<text> message, 4-120 

ESCAPE key, 3-1 

Escape sequence, 4-38 

ESC character, 4-36, 


4-38, 4-44 


ESC echo, dollar sign ($) character 


as, 3-l 
ESC SEQ command, 4-38 
EVEN PARITY command, 4-37, 4-47 
Exclamation character (!) in 
BATCH command, 4-87 
Executing a program, 2-13 
EXIT command, 4-39 
/EX option in PIP (16K), 4-140 


Extended PIP program, see PIP (16K) 


Extensions in OLD command, 2-20 


FAILURE TO ATTACH TO JOB x 
message, 4-8, 4-11 

/7FA option in PIP (8K and 16K), 
4-24, 4-29 

Fast copying, 4-131 

Fast logout, 4-14 

FATAL SYSTEM I/O FAILURE, 4-17 

/FC option in COPY, 4-131 

7FC OR /NC MISSING -- PLEASE TRY 
AGAIN message, 4-132 

FF character, 4-34, B-4 

FILCOM system program, 

7P option in, 4-128 


4-123 


File, 
date of creation, 
date of last access, 
deletion, 4-14, 4-25 
listing on line printer, 2-17 
merging, 2-20, 4-23 
protection, 2-21 
renaming, 2-21 
system library, 2-22 
File directories, listing, 4-27 
FILE EXISTS-RENAME/REPLACE 
message, 2-17 
Filename specification, 
in BATCH, 4-90 
File names with non-file 
structured devices, 2-14 
FILE OR ACCOUNT ALREADY EXISTS 
message, 4-149 
Files, 
comparing, 4-123 
deleting, 4-26, 4-145 
preserving, 4-59 
recalling, 4-59 
renaming, 4-143 
replacing in BACKUP, 4-68 
superseding in BACKUP, 4-68 
transferring, 4-59, 4-142 
transferring library, 4-29 
File size, determining, 2-24 
/FILES:n switch in S$SORT command, 
4-106 
File specifications, wild card, 
4-136 ; 
File transfer, 4-21 
guidelines, 4-28 
optimizing, 4-31 
Fill character, 4-36 
FILL characters for VT05, 
Fill factor, 4-36 
FILL LA30S command, 
FILL n command, 4-36, 
Fill option, 4-45 
Fills, control characters 
requiring, 4-46 
Floating point calculations, 2-34 
Floppy disk, RX1l1, 5-36 
7F option in SYSTAT, 4-16 
/FORMAT:nn option in QUE, 4-77 
/FORMAT:U option in PIP (16K), 
4-141 
/FORMAT:V option in PIP (16K), 
4-141 
FORM command, 4-34 
Forms control, 
embedded, 4-77 
FORTRAN, 4-77 
implied, 4-77 
FORTRAN forms control, 
FP, 4-19 
Fractional computations, 2-34 
Free blocks, number of, 4-49 


2-24 
2-24 


5-23 


4-36 
4-46 


4-77 
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FULL DUPLEX command, 4-35 
Full (Slow) directory, 4-27 
Functions, summary of, A-2 


Generalized fill characters, 4-45 

Generating NUL characters, 4-35 

GO option in PIP (8K and 16K), 
4-24 

GRIPE system program, 4-53 

Guidelines for transferring files, 
4-28 


Hardware form feed, 4-34 
Hardware tab, 4-34 
HB, 4-19 
HELLO command, 2-1, 2-6, 4-6 
HELP as a CCL command, 4-2 
HELP command, 2-6, 4-39 
/HELP switch in $COBOL command, 
4-104 

/HE option, 

in PIP (8K and 16K), 4-24, 4-141 
High-speed paper tape punch, 5-5 
High-speed paper tape reader, 5-5 
High-speed paper tape unit, 5-4 
Hung terminal, 4-18 
Hung terminal count, 4-18 


/1:A option in BACKUP, 4-64 
I command, 4-6 
/I:F option in BACKUP, 4-64 
ILLEGAL FILE NAME error, 2-31 
ILLEGAL INPUT FILE error, 4-77 
ILLEGAL NUMBER error, 2-28 
Implied forms control, 4-77 
INDIRECT COMMAND ERROR - COMMAND 
STACK OVERFLOW message, 4-149 
Indirect command files in PIP 
(16K), 4-148 
INIT, 4-19 
/IN option in PIP (16K), 4-140 
in delete comamnds, 4-146 
in rename commands, 4-144 
in transfer commands, 4-143 


Input file defaults in PIP (16K), 
4-137, 4-139 

Input file specification in PIP 
(8K), 4-28 


Input of the new program, 2-7 
/INPUT switch, 
in S$COPY command, 4-97 
in $DIRECTORY command, 4-99 
in $SORT command, 4-107 


Inspect feature, 
in BACKUP, 4-68 
in delete commands, 4-146 
in LOGOUT, 2-4 
in rename commands, 4-144 
in transfer commands, 4-143 
option in PIP (16K), 4-140 
INTERLOCK error message in 
BACKUP, 4-59 
INUSE system program, 4-129 
INVALID DEVICE error (PIP 16K), 
4-138 
INVALID ENTRY - TRY AGAIN message, 
2-2, 4-6 
/I option in BACKUP, 4-64, 4-68 
I/O state indicator, 4-19 


Job attaching, 4-8 

$JOB command, 4-93 

JOB DEFERRED BY OPERATOR message 
in BATCH, 4-101 

Job, detached, 4-5 

Job, 

detaching, 2-13 

JOB KILLED BY OPERATOR message in 
BATCH, 4-101 

/JOB:n option in UMOUNT, 4-121 

Job number, determining, 4-9 

JOB NUMBER TO ATTACH TO query, 4-8 

Job priority, determining, 4-18 

Job processing in BATCH, 4-109 

JOB RESTARTED BY OPERATOR message 
in BATCH, 4-101 


Job status information, 4-18 


K command in QUE, 4-81 
KCT's, 4-51 
Keyboard, 
ASR-33 Teletype, 5-2 
BCD, 5-33 
CALL 360/BASIC, 5-34 
correspondence code, 
EBCD, 5-32 
status of, 
vT05, 5-22 
Keyboard number, determining, 
4-5, 4-9 
KEY command, 
Key, 
DEL, 2-8 
ESC, 3-1 
LINE FEED, 
RETURN, 3-1 
RUBOUT, 2-8, 


5-31 


4-17 


2~26 


3-1 


3-1 
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/KEYS:abm.n switch in $SORT 
command, 4-107 

KI, kill in BATCH, 4-101 

Killing queued requests in QUE, 
4-81 

Kilo-core ticks used, 4-51 

/Kn option in SYSTAT, 4-16 


Labeling format, magtape, 
assigning, 2-33, 4-120 
determining, 4-16, 4-19 

Language summary, BASIC-PLUS, A-1 

LA36 DECwriter II, 5-35 


LC INPUT command, 4-36, 4-44, 4-45 
L command in QUE, 4-80 
LC OUTPUT command, 4-34, 4-45 


/L:device option in BACKUP, 4-64 
/L:filename.ext option in BACKUP, 
4-64 
LENGTH command, 2-24 
/UIMIT switch in $JOB command, 
4-93 
Line deletion, 3-2 
LINE FEED key, 3-1 
Line number in LIST command, 
Line printer, 
character set, 5-8 
controls, 5-9, 5-10 
listing a program on, 2-17 
LP1ll, 5-7 
queue a request to, 4-78 
LINE variable, 2-12 
Line width, 4-34 
/LI option in PIP (16K), 4-141 
LIS file type in BATCH, 4-91 
LIST command, 2-9, 2-10 
comma (,) character in, 2-9 
dash (-) character in, 2-9 
line number in, 2-9 
Listing, 
account, 2-25 
device directory, 
4-27, 4-113 
directory in BACKUP, 4-69 
directories in BATCH, 4-98 
disk quota, 4-49 
file directories, 4-27 
line printer, 2-9, 2-17 
LISTNH command, 2-10 
LIST printout, 
program header in, 2-9 
question mark (?) character in, 
2-10 
/LIST switch, 
in SBASIC command, 4-95, 4-96 
in S$COBOL command, 4-104, 4-105 
Loading a program, 2-19 
Load map, COBOL program 4-104 
LOCAL ECHO command, 4-35 


2-9 


2-24, 2-25, 


Local installation name, 4-6 
Locked status, 4-18 
Locking a private disk, 4-120 
/LOCK option in UMOUNT, 4-120 
/LOD switch in $COBOL command, 
4-104 
LOG command, 4-6 
LOG file type in BATCH, 4-91 
Logged Out commands, 2-6, 4-12 
LOGIN, 4-5 
QUE/L, 4-85 
SET, 4-33 
SYS, 4-17 
Logging into the system, 2-1 
Logging off the system, 2-3 
Logical assignment of account, 
2-30, 2-31 
Logical assignments in BATCH, 
4-102 
Logical line continuation, 3-1 
Logical name reserving, 2-28 
Logical names, colon (:) 
character in, 2-30 
/LOGICAL option in $MOUNT command, 
4-102 
LOGIN command, 4-6 
LOGIN system program, 4-5 
comma (,) character in, 4-6 
number sign (#) character in, 
2-1 
running logged in, 4-9 
running logged out, 4-5 
slash (/) character in, 27-3 
/L option in BACKUP, 4-64 
when detached, 4-70 
LOGOUT system program, 4-13 
inspect feature in, 2-4 
question mark (?) character in, 
4-13 
Lower case characters, 
echoing, 4-36 
translating, 4-36 
Low speed paper tape punch, 5-3 
Low speed paper tape reader, 5-3 
LP, 4-19 
LP11 line printer, 5-7 


4-34, 4-44 


Macro commands, TTYSET table of, 
4-42 
Magtape, 
assigning labeling default, 
2-33, 4-120 
characteristics in BACKUP, 4-63 
continuation in BACKUP, 4-68 
control and transport, 5-15 
copying, 4-133 
density and parity settings, 
4-133 
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Magtape (cont.), 
labeling default, 
changing, 2-33 
determining, 4-16, 4-19 
operating procedures, 5-18 
rewinding in UMOUNT, 4-122 
threading diagram, 5-20 
transport controls, 5-16, 5-17 
transport indicators, 5-17 
Map, DATA division, 4-104 
MAP file type, 4-104 
/MAP switch in SCOBOL command, 
4-104 
MAXIMUM CORE EXCEEDED error in 
BACKUP, 4-71 
Merging files, 2-20, 4-23 
two source programs, 2-20 
SMESSAGE command, 4-101 
Messages, communicating, 4-53 
MISSING SPECIAL FEATURE error 
message, 2-34 
/MODE:n option in QUE, 4-77 
MONEY system program, 4-51 
7M option in BACKUP, 4-71 
when detached, 4-70 
MORE > message in QUE, 4-79 
/MORE option, 
in PIP (16K), 4-141, 4-150 
in QUE, 4-78 
MOUNT as a CCL command, 4-119 
SMOUNT command, 4-102 
Mounted disks, number of, 4-18 
Mounting a private disk, 4-119 
MT, 4-19 
MUST HAVE DIFFERENT DEVICE UNITS 
message, 4-131 
MUST HAVE SAME TYPE DEVICES 
message, 4-131 


Name, 
changing program, 2-21 
local installation, 4-6 
logical, 2-28 
system, 4-6 

NAME AS statement, 2-21 


/NAME switch in $JOB command, 4-93 


/NC option in COPY, 4-132 
Negating a switch in BATCH, 4-92 


Negation characters in BATCH, 4-93 


NEW command, 2-6 

NEW FILE NAME-- message, 2-6 

NEXT MAGTAPE UNIT # message, 4-68 

1968 ASCII character set, 
terminals with, 4-44 

/n,m option in SYSTAT, 4-16 

NO ESC SEQ command, 4-39 

NO FILES MATCHING message, 4-149 

NO FILL command, 4-36, 4-46 

NO FORM command, 4-34 


No header option in QUE, 4-78 
NO in BATCH command switch, 4-92 
NO LC INPUT command, 4-36, 4-44, 
4-45 
NO LC OUTPUT command, 4-34, 4~45 
/NOLIMIT switch in $JOB command, 
4-94 
/NOLIST switch, 
in $BASIC command, 4-95 
in $COBOL command, 4-104 
NONAME program, 2-7 
/NONAME switch in $JOB command, 
4-93 
/NOOBJECT switch, 
in $BASIC command, 4-95 
in $COBOL command, 4-104 
NO PARITY command, 4-37, 4-47 
/N option in QUE, 4-78 
/n option in SYSTAT, 4-16 
Normal directory, 4-27 
NO ROOM FOR USER ON DEVICE error 
in BACKUP, 4-66 
NO ROOM FOR USER ON DEVICE error 
message, 4-135 
/NORUN switch, 
in S$BASIC command, 4-95 
in $COBOL command, 4-104 
NO SCOPE command, 4-36 
NO STALL command, 4-38 
NO TAB command, 4-34 
NOT A VALID DEVICE error, 2-30 
NOTICE.TXT system library file, 
4~7 
NO UP ARROW command, 4-38 
NO USEFUL OPTION SPECIFIED -- 
PLEASE TRY AGAIN message, 
4-132 
/NOWRITE option in $MOUNT command, 
4-102 
NO XON command, 4-35, 4-47 
NUL character generation, 4-35 
NUL characters, 4-45 
Number sign (#) character, 
in EDIT, 4-55 
in LOGIN, 2-1 
Number, system version, 4-6 


/OBJECT switch, 
in $BASIC command, 4-95, 4-96 
in $COBOL command, 4-104, 4-105 
-OBJ file type in BATCH, 4-91 
Object program, 2-16 
ODD PARITY command, 4-37, 4-47 
OLD command, 2-18 
extensions, 2-20 
OLD FILE NAME-- message, 2-19, 
2-20 
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Open files, number of, 4-18 
Operating procedures in BATCH, 
4-109 
Operator account, system, 4-18 
Operator controls, DECwriter, II, 
5-35 
Operator control (/WAIT) in 
BATCH, 4-101, 4-103 
Operators, summary of BASIC-PLUS, 
A-1 
OPR, 4-19 
Optimizing file transfers, 4-31 
Option, software, 
character translation, 4-45 
fill, 4-45 
Options, 
BACKUP, 
general, 4-64 
privileged, 4-71 
COPY, 4-131, 4-132, 4-133 
DIRECT, 4-114, 4-115 
EDIT, 4-55 
FILCOM, 4-128 
LOGOUT, 4-13 
PIP (8K and 16K), 
file deletion, 4-25 
file renaming, 4-23 
file transfer, 4-24 
listing device directories, 


4-27 
zeroing device directories, 
4-26 
PIP (16K), 4-140, 4-141 
QUE, 
command, 4-78 
job output, 4-77 
SYSTAT, 4-16 
TTYSET, 
RSTS, 4-140 


RSTS/E, 4-134 
UMOUNT, 4-120, 4-121, 4-122 
Output parity bit, 4-47 
OUTPUT STATUS TO? query, 
/OUTPUT switch, 
in $COPY command, 4-97 
in $SORT command, 4-107 


4-15 


Pack cluster size determining, 4-18 
PACK ID'S DON'T MATCH error, 
4-120 

Pack label, 

colon character, (:), with, 2-31 
Paper tape input, 2-26 
Paper tape punch, 

high-speed, 5-5 

low speed, 5-3 
Paper tape reader, 

high-speed, 5-5 

low speed, 5-3 


Paper tape unit, high-speed, 5-4 
Parity bit, 4-37 
output, 4-47 
/PARITY option in COPY, 4-133 
Parity settings in magtape, 4-133 
Password, 2-1] 
PASSWORD: message, 
Patch file, 4-128 
Peripheral Interchange Program, 
see PIP 
/PHYSICAL option in $MOUNT command, 
4-102 
PIP as a CCL command, 4-31 
PIP determining version, 4-135 
PIP options, see Options in PIP 
PIP (8K) system program, 
input file, 4-22 
output file, 4-22 
version description, 4-21 
PIP (8K and 16K) system programs, 
changing file names, 4-23, 4-24 
changing protection codes, 4-25 
command definition, 4-21 
CTRL/Z combination in, 4-21 
deleting files, 4-25 
file transfers, 4-23 
guidelines for transfers, 4-28 
listing device directories, 
4-27 
merge operations, 4-23 
optimizing file transfers, 4-31 
options, see options in PIP 
zeroing device directories, 4-26 
PIP (16K) system program, 4-135 
additional options, 4-140 
ANSI magtape files in, 4-146 
asterisk (*) character in, 4-136 
CMD extension in, 4-149 
commercial at (@) character in, 
4-148, 4-149 
delete commands in, 4-145 
directory listing commands, 
4-142 
extending the command line, 
4-150 
general input defaults, 4-137 
indirect command files in, 
4-148 
input defaults for transfer and 
directory commands, 4-139 
INVALID DEVICE error, 4-138 
list of features, 4-135 
output defaults for transfer 
and directory commands, 
4-138 
question mark (?) character in, 
4-136 
rename commands, 4-143 
transfer commands, 4-142 
wild card specifications, 4-136 
PIP.TXT system file, 4-141 


2-1 
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PK, 4-19 
PLEASE USE THE 'MOUNT' OR 
"DISMOUNT' COMMAND message, 
4-119 
Plus (+) character in BATCH 
commands, 4-97 
/P option in FILCOM, 4-128 
PP, 4-19 
PR, 4-19 
Pre-extend a disk file, 4-140 
PREFIX character, 4-44 
Preserving files, 4-59 
SPRINT command in BATCH, 4-98 
Printer, 
high quality, 5-27 
line, 5-7 
output to, 2-18, 4-23 
Teletype, 5-3 
Printing at control terminal 
BATCH, 4-101 
PRIORITY column, 4-18 
Priority determining, job, 4-18 
Priority option in QUE, 4-77 
/PRIORITY:n switch in $JOB 
command, 4-94 
Private disk, 
locking, 4-120 
mounting a, 4-119 
preserving files on, 4-65 
removing a, 4-121 
status of, 4-16 
Privileged BACKUP commands, 4-70 
Privileged options in BACKUP, 
4-71 
/PRin option in QUE, 4-77, 4-80 
PROCESS ERROR IN DISMOUNT - 
<text> message, 4-121 
PROCESS ERROR IN MOUNT - 
<text> message, 4-120 
Processing ANSI magtape files, 
4-146 
/PROCESS:x switch in SSORT 
command, 4-106 
Programmer number, 2-1 
Program, see also file, 2-24 
Program, 


changing protection, 2-21, 4-23 


compiling, 2-16 

continuation, 2-12 

creation, 2-6 

debugging, 2-12 

deleting all liens in, 2-11 

deleting lines from, 2-10 

deletion, 2-23 

detaching, 2-13 

determining size, 2-24, 4-17 

editing, 2-8, 4-55 

in memory, 
clearing, 2-7 
creating, 2-7 
deleting, 2-7 
renaming, 2-1 


Program (cont.), 
listing a, 2-9 
loading, 2-19 
merging, 2-20 
name default, 2-7 
NONAME, 2-7 
recalling, 2-19 
resuming, 2-12 
running, 2-13 
running from a logged out 
terminal, 4-12 
running in BATCH, 4-95 
segmenting, 2-15 
storing, 2-17, 2-18 
system, see System Program 
update, 2-23 
Programs, system, 
list of, 4-1 
Project number, 2-1 
Project-programmer number, 2-1 
Protection code, 
changing, 2-21, 4-23, 4-144 
changing system default, 2-32 
determining, 2-24 
PROTECTION VIOLATION error message 
in BACKUP, 4-60 
/PRX:n option in PIP (16K), 4-140 


Q command options, 
table of, 4-78 
Q command, using, 4-76 
/Q option in BACKUP, 4-71 
QUE as a CCL command, 4-85 
QUE/L dev: command, 2-6, 4-85, 
4-86 
QUEMAN system program, 4-71 
Question mark (?) character, 
in BATCH, 4-111 
in EDIT, 4-56 
in LIST printout, 2-10 
in LOGOUT, 4-13 
in PIP (16K), 4-136 
in QUE, 4-77 
in TTYSET, 4-33 
QUE system program, 4-71 
asterisk (*) character in, 4-77 
command options, 4-78 
continuing a command line, 4-79 
equals (=) character in, 4-76 
error messages and codes, 4-83, 
4-84 
job output options, 4-77 
K command in, 4-81 
killing queued requests, 4-81 
listing queued requests, 4-80 
MORE > message in, 4-79 
number sign (#) character in, 
4-73 
question mark (?) character in, 
4-77 
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QUE system program (cont.), 
queuing a BATCH job, 4-109 
request limit, 4-73 
running at a terminal, 4-73 


running at a logged out terminal, 


4-85 
running by CCL command, 4-85 
running by chaining, 4-82 
Slash (/) character in, 4-85 
Queued requests, 
listing, 4-80 


QUEUE NOT INITIALIZED message, 4-73 


Queue request to line printer, 
4-78, 4-79 
QUEUE.SYS system file, 4-73 
QUOLST system program, 4-49 
Quota, 
account, 4-51 
disk, 4-49 
used, 
at logout, 4-14 
on disk, 4-49 
QUOTA EXCEEDED message, 4-14 
/Q:X option in BACKUP, 4-71 


RADIX-50 character/position 
table, D-5 
RADIX-50 character set, D-4 
RE, restart in BATCH, 4-101 
READY message, 2-2 
REALLY ZERO, 
account question, 4-26 
device question, 4-26 
query in BACKUP, 4-67 
REASSIGN command, 2-28 
Recalling a program, 2-19 
Recalling files, 4-59 
from DECtape in BACKUP, 4-67 
Releasing a device, 2-28 
Remote reader control, 
option, 4-46 
XON/XOFF, 4-46 
Removing all files, 4-26 
Removing a private disk, 4-121 
RENAME command, 2-11 
Rename commands, 
PIP (8K), 4-23, 4-24, 4-25 
PIP (16K), 4-143 
inspect feature in, 4-144 
Renaming a file, 2-21 
Renaming a program, 2-21 
in memory, 2-11 
/RE option, 
in PIP (8K), 4-23, 4-24, 4-25 
in PIP (16K), 4-143, 4-144, 
4-145 
REPLACE command, 2-23 
Replacing files in BACKUP, 4-68 
Reserving a device, 2-27 


Reserving a logical name, 2-28 
Residency indicator, 4-19 
Restart option in QUE, 4-78 
Restructuring accounts, 4-26 
Resuming a program 2-12 
RETURN key, 3-1 
RETURN key, 2741 
lower case, 5-28 
upper case, 5-28 
/RIN switch in $SORT command, 
4-107 
RN, 4-19 
/Rin option in QUE, 4-78 
RS, 4-19 
/R option, 
in BACKUP, 4-64, 4-66, 4-67 
in QUE, 4-78 
in SYSTAT, 4-16 
/ROUT switch in S$SORT command, 
4-107 
RSTS/E TTYSET commands, 4-34 
RUBOUT character, 4-36 
RUBOUT echo, backslash (\) 
character, 3-2 
RUBOUT key, 2-8, 3-1 
RUN command, 2-13 
SRUN command, 4-100 
RUNNH command, 2-13 
Running a program, 2-13 


from a logged out terminal, 4-12 


Running LOGIN, 
at a logged in terminal, 4-9 


from a logged out terminal, 4-5 


Running system programs, 2-22, 
2-23 
in BATCH, 4-100 
/RUN switch, 
in $BASIC command, 4-95 
in $COBOL command, 4-104 
RUN-TIME column, 4-18 


Run time system information, 4-18 


Run time user switches in $COBOL 
command, 4-104 


/RW:NO option in PIP (8K and 16K), 


4-24 
RX11 floppy disk, 5-36 


SAVE command, 2-17 

SCALE command, 2-34 

Scaled arithmetic feature, 2-34 

Scale factor, 2-34 

determining, 2-35 

SCALE FACTOR INTERLOCK warning 
message, 2-36, 2-38 

SCOPE command, 4-35 

Segmenting a program, 2-15 

Selectable translation option, 
4-44 

SELF, 4-19 
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4-47 
4-33 


SET as a CCL command, 
SET xxxx command, 2-6, 
SIZE column, 4-18 
/SIZE:n switch in $SORT command, 
4-106 

Slash (/) character, 

in BACKUP, 4-63 

in BATCH commands, 4-88, 4-92 

in COPY, 4-131, 4-132, 4-133 

in DIRECT, 4-114 

in EDIT, 4-55 

in FILCOM, 4-128 

in LOGIN, 2-3, 4-6 

in PIP (8K and 16K), 4-23 

in QUE, 4-76, 4-77, 4-85 

in SYSTAT, 4-16, 4-17, 4-19, 

4-20 

in UMOUNT, 
SL, 4-19 
SLEEP state indicator, 4-19 
Small PIP, see PIP (8K) 
/S option, 

in BACKUP, 4-64, 

in SYSTAT, 4-16 
SSORT command, 4-106 

Table of switches, 4-106, 4-107 
SORT11 PDP-11 Sort program, 4-106 

running by BATCH, 4-106 


4-120, 4-121, 4-122 


4-66, 4-68 


running on-line, see PDP-11l Sort 


Reference Manual 
Source data in BATCH, 4-100 
Source file, 2-19 
Source programs, 2-17 
editing, 2-8, 4-55 
merging two, 2-20 
/SOURCE switch, 
in SBASIC command, 4-95 
in $COBOL command, 4-105 
Source version, 2-16 
Spaces in BATCH command, 4-87 
Special control characters, 3-1 
Special control character summary, 
B-3 
/SPECIFICATION switch in $SORT 
command, 4-107 
SPEED n command, 4-37 
Spheres, typing, 5-30 
SPLIT SPEED I/O command, 4-37 
Spooling jobs, creating requests 
for, 4-73 
SPOOL program under BATCH, 4-98 
-SRT file type in BATCH, 4-91 
STALL command, 4-37 
STATE column, 4-18 
Statement, 
CHAIN, 2-15 
NAME AS, 2-21 
STOP, 2-12 
Statements, BASIC-PLUS 
summary of, A-6 


Status information, 4-15 
at a logged out terminal, 
buffers, 4-18 
device, 4-17 
disk, 4-18 
full system, 4-17, 4-18 
job, 4-17 
run-time system, 4-17 
STOP AT LINE x message, 2-12 
STOP statement, 2-12 
Storing a program, 2-17, 2-18 
Summary, 
BASIC-PLUS commands, B-1l 
BASIC-PLUS statements, A-6 
COBOL statements, see COBOL 
Language Reference Card 
control characters, B-3 
functions, A-2 
error messages, 
operators, A-1 
variable types, A-1 
Superseding files in BACKUP, 4-68 
Suppressing terminal printing, 3-3 
Suspending terminal output, 3-4 
Switch in BATCH, negating, 4-92 
SW, 4-19 
Swapped out indicator, 4-19 
Synchronization standard, 4-35, 
4-37 
SYNTAX ERROR message, 2-34 
Syntax rules, BATCH command, 4-89 
SYS command, 2-6, 4-17 
as a CCL command, 4-19, 4-20 
SYSTAT abbreviations, list of, 
4-19 
SYSTAT options, list of, 4-16 
SYSTAT system program, 4-15 
System accounting, 4-51 
System date, current, 4-6 
System disk transfer in BACKUP, 
4-70 
System file, 
DIRECT.HLP, 4-115 
NOTICE.TXT, 4-7 
PIP.TXT, 4-141 
QUEUE.SYS, 4-73 
TTYSET.SPD, 4-37 
System identification message, 2-1 
System library files, 2-22 
System name, 4-6 
System program, 
BACKUP, 4-59 
BACKDK, 4-59 
BATCH, 4-87 
COBOL, 4-1 
COPY, 4-131 
DIRECT, 4-113 
EDIT, 4-55 
FILCOM, 4-123 
GRIPE, 4-53 


4-17 


C-1 
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System program (cont.), 

INUSE, 4-129 

LOGIN, 4-5 

LOGOUT, 4-13 

MONEY, 4-51 

PIP (8K), 4-21 

PIP (16K), 4-135 

QUE, 4-71 

QUEMAN, 4-71 

QUOLST, 4-49 

RUNOFF, 4-1 

SORT11, 4-2 

SYSTAT, 4-15 

TTYSET, 4-33 

UMOUNT, 4-119 
System programs, list of, 4-1 
System status report, 4-17 
System version number, 4-6 


TAB character, 3-4 
TAB command, 4-34 
Tables in manual, 
list of, vii 
TAPE command, 2-25 
TAPE mode, 2-26 
TCll DECtape controller, 5-11 
TC11/TU56 DECtape, 
control, 5-11 
transport, 5-11 
units, 5-11 
Teletype, ASR-33, 5-1 
Terminal, 
assigning a, 2-27 
connect time used, 4-51 
detaching from, 2-13 
determining status of, 4-16 
determining the keyboard 
number of, 4-6, 4-9 
disabling echo, 2-25 
enabling echo, 2-26 
hung count, 4-18 
I/O state, 4-17 
logged out, 
running programs from, 4-12 


setting characteristics of, 4-33 


suppressing printing, 3-3 
suspending output, 3-4 


VTO5 alphanumeric display, 5-21 


warning message, 4-129 
Text editing, 4-55 
Ticks used, kilo-core, 4-51 
Tilde (~) character, 4-36 
Time of creation, file, 2-24 
Time of day, 
determining, 4-6 
Time used, 
cumulative by job, 4-17 
device, 4-51 
during login, 4-14 
elapsed time, 4-14 
run time, 4-14 


Time used (cont.), 
terminal connect, 4-51 
to date by account, 4-51 
TJUL6 magtape transport, 5-15 
TM11 controller, 5-16 
Transfer, ASCII type, 4-28 
Transfer commands, PIP (8K), 4-23 
Transfer commands, PIP (16K), 
4-142 
' inspect feature in, 4-143 
TRANSFER COMPLETE message, 4-57 
Transferring a compiled file, 4-30 
Transferring binary files, 4-29, 
4-30 
Transferring control of a device, 
2-28 
Transferring files, 4-21 
guidelines for, 4-28 
Transferring multiple files, 4-59, 
4-136 
Transfers, 
binary files, 4-29, 4-30 
block by block, 4-29 
DECtape to disk, 4-30 
disk to DECtape, 4-29 
compiled, 4-30 
contiguous, 4-30 
optimizing, 4-31 
Translation of characters, 4-45 
Translation of lower case 
characters, 4-36 
Translation option, 4-45 
Transmission code identifiers, 
2741, 5-30 
Transmit interrupt, 4-35 
Transmit resume, 4-35 


TT, 4-19 
TTYSET.SPD, system library file, 
4-37 


TTYSET system program, 4-33 
CTRL/Z combination in, 4-33 
effecting XON/XOFF remote 
reader control, 4-46 

error messages, 4-43 

macro commands, 4-42 

setting generalized fill 
characters, 4-46 

setting parity for terminals, 
4-47 


setting terminal characteristics, 


4-33 
terminating, 4-39 
translating special characters, 
4-44, 4-45 
treating ESC characters, 4-44 
TU56 DECtape transport, 5-11 
TULO magtape transport, 5-15 
2741 communications terminals, 
5-27 
ATTN key, 
lower case, 5-28 
upper case, 5-28 
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2741 communications terminals 
(cont.), 
brackets ([ and ]), 5-29 
BKSP key, 
lower case, 5-28 
upper case, 5-28 
changing codes, 5-29 
keyboards, 5-31, 5-32, 
5-34 
RETURN key, 
lower case, 5-28 
upper case, 5-28 
transmission code identifiers, 
5-30 
Typing spheres, 5-30 


5-33, 


UFD, determining cluster size, 
4-51 
UIC, 4-143 
UMOUNT system program, 4-119 
/ANSI option in, 4-121 
/DOS option in, 4-120 
/JOB option in, 4-121 
/LOCK option in, 4-120 
magtape rewinding, 4-122 
options, 4-120 
/UNLOAD option in, 4-122 
/UNLOAD option in UMOUNT, 4-122 
Unlocked status, 4-18 
UNSAVE command, 2-23 
UP ARROW command, 4-38 
Updating a program, 2-23 
/UP option in PIP (8K and 16K), 
4-24 
Upper case characters, 4-44 
Used blocks, number of, 4-49 
User File Directory, see UFD 
User Identification Code, see 
UIC 
User switches (run time) in $COBOL 
command, 4-104 
/USW:n:n ... switch in S$COBOL 
command, 4-104 


Variable types, summary of, A-l 

/VE option in COPY, 4-132 

Version numbers, xi 

Version number, system, 4-6 

Vertical tab control, 4-34 

/VID:label option in PIP (16K), 
4-140 

/VID option in SMOUNT command, 
4-102 

Volume identification in BATCH, 
4-102 

/V option in BACKUP, 4-64, 4-70 

VT characters, 4-34 


VT05 alphanumeric display 
terminal, 5-21 
vVT05, fill characters for, 5-23 
controls and switches, 5-25, 
5-26 


/WAIT switch 
in $DISMOUNT command, 4-103 
in SMESSAGE command, 4-101 
WHAT? error message, 4-9 
WHERE column, 4-18 
WHO column, 4-18 
WIDTH n command, 4-34 
Wild card specifications, 4-136 
Wipe out option in PIP (16K), 
4-140 
/WO option in PIP (16K), 4-140 
/W option in BACKUP, 4-71 
/WRITE option in S$MOUNT command, 
4-102 
Writing zeroes in PIP (16K), 4-140 


XOFF character, 

XON character, 4-35, 4-37 

XON command, 4-35, 4-47 

XON/XOFF remote reader control, 
4-46 


4-35, 4-37 


/% option in BACKUP, 4-63, 4-64, 


4-67, 4-68 

/ZE option for ANSI magtape, 
4-140 

/ZE option in PIP (8K and 16K), 
4-26 


Zeroing, 4-26 
ANSI magtape, 4-140 
in BACKUP, 4-67 
/0,0 option in SYSTAT, 4-16 
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NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion, Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 
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